Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

AI agents cannot invite reviewers to private YouTube videos via YouTube Data API

Đang mở
  • Có gì không ổn?
#3,932 1 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
32/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Ít trao đổi
Công nghệ
node.js, typescript
Lĩnh vực
api

Hướng nghiên cứu

Bắt đầu với repository tái hiện được liên kết, chạy index.ts bằng các biến môi trường đã được ghi rõ và kiểm tra request trực tiếp videos.update của nó bằng part=recipients. So sánh request đó với tài liệu API YouTube videos và issue liên quan #3626; công việc được xem là hoàn tất khi xác nhận được một API/client surface được hỗ trợ để thêm, liệt kê và xóa những người xem được mời, hoặc có tài liệu rõ ràng cho biết không tồn tại API/client surface nào như vậy.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Please make sure you have searched for information in the following guides.
A screenshot that you have tested with "Try this API".
Image

Errors from the screenshot:

Property "recipients" does not exist in object specification.

You have invalid or missing required parameter values above. If you execute anyway, the response will likely be an error.

API response from the screenshot:

{
  "error": {
    "code": 400,
    "message": "'recipients'",
    "errors": [
      {
        "message": "'recipients'",
        "domain": "youtube.part",
        "reason": "unknownPart",
        "location": "part",
        "locationType": "parameter"
      }
    ]
  }
}
Link to the code that reproduces this issue. A link to a public Github Repository or gist with a minimal reproduction.

https://github.com/karlhorky/repro-youtube-api-private-video-recipients

A step-by-step description of how to reproduce the issue, based on the linked reproduction.
  1. Clone the linked reproduction repository.
  2. Set YOUTUBE_ACCESS_TOKEN to an OAuth access token for the Google account that owns the test video.
  3. Set YOUTUBE_VIDEO_ID to the ID of a video owned by that account.
  4. From the repository root, run:
    YOUTUBE_ACCESS_TOKEN='...' YOUTUBE_VIDEO_ID='...' node index.ts
  5. The script calls the YouTube Data API videos.update endpoint directly with fetch, using part=recipients.
  6. The request body includes the video ID and an attempted invited-viewer list.
  7. The API rejects the request because recipients is not a supported part.

Expected: the API supports adding invited viewers to a private YouTube video, or documents the supported equivalent.

Actual: the API rejects the request before any invited-viewer validation can happen, because there does not appear to be a supported API surface for private-video invited viewers.

A clear and concise description of what the bug is, and what you expected to happen.

AI-agent workflow blocked: AI agents can upload or update private YouTube videos through the API, but cannot invite specific human reviewers to those private videos.

(also applies to regular scripts and other automation)

YouTube Studio supports account-based access control for private videos: a creator can invite specific Google accounts by email address to view a private video.

The YouTube Data API and generated Node.js client do not appear to expose this same capability.

I expected the API to allow automation of the same private-sharing workflow available in YouTube Studio:

  • Set a video to Private
  • Add invited viewers by email address / Google account
  • List invited viewers
  • Remove invited viewers

Instead, the API rejects the recipients part as unsupported.

This blocks AI agents (for example with Antigravity CLI or Codex CLI or Claude Code, etc). A common agentic workflow is:

  1. Upload or generate a draft video
  2. Keep it private
  3. Invite a specific reviewer, client, student or teammate
  4. Wait for human review
  5. Update the video, publish it later or revoke access

Because the API cannot manage invited viewers, AI agents and other automation systems using private videos are pushed toward:

  1. brittle browser automation against YouTube Studio using Playwright MCP or similar
  2. unofficial client libraries that depend on undocumented YouTube Studio internals, such as https://github.com/adasq/youtube-studio
A clear and concise description WHY you expect this behavior, i.e., was it a recent change, there is documentation that points to this behavior, etc. **

I expect this behavior because YouTube Studio already supports this private-video sharing workflow in the UI:

Video:

https://github.com/user-attachments/assets/4dbacac6-28bb-462c-898f-6ae0a672de67

Screenshots:

Image Image Image

The YouTube Data API currently documents status.privacyStatus for videos, including private, but there does not appear to be a documented way to manage the invited users for a private video:

https://developers.google.com/youtube/v3/docs/videos

This means there is a mismatch between YouTube Studio functionality and the public API/client surface.

A related earlier report also ran into the same missing API surface when trying to use a recipients part:

Expected behavior:

The API should expose a documented way to manage private-video invited viewers, for example:

  • Adding invited viewers: support a privateSharing / recipients part on videos.update, a videos.permissions.insert method or another documented endpoint for adding account-based private video access
  • Listing invited viewers: support a privateSharing / recipients part on videos.list, a videos.permissions.list method or another documented endpoint for reading the current invited-viewer list
  • Removing invited viewers: support a privateSharing / recipients part on videos.update, a videos.permissions.delete method or another documented endpoint for revoking account-based private video access
  • Validating invited viewers: return clear errors for invalid emails, non-Google accounts, quota issues and permission issues

At minimum, the API should support:

  • Adding invited viewers
  • Listing invited viewers
  • Removing invited viewers
  • Returning clear validation errors for invalid emails, non-Google accounts, quota issues and permission issues
Ngôn ngữ chính
TypeScript
Star
12.3k
Fork
2k
Merge trung bình
1 ngày 19 giờ
Pull request đã merge (30 ngày)
21

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của googleapis/google-api-nodejs-client

Tất cả issue của googleapis/google-api-nodejs-client

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.