如何通过YouTube Data API设置视频仅频道成员可见？

要实现视频仅频道成员可见的设置，不能仅靠privacyStatus字段，需要结合status对象下的membersOnly布尔属性来完成，具体操作如下：

核心参数说明 #

YouTube Data API v3中，「仅频道成员可见」的权限是通过以下两个参数组合实现的：

• status.privacyStatus: 设置为private
• status.membersOnly: 设置为true

其中membersOnly字段专门用于标记视频为会员专属内容，这个字段在基础上传教程里可能未被重点提及，但属于官方API的标准字段。

操作步骤 #

1. 确认权限配置 #

调用API时需要包含以下权限范围（scope）：

• https://www.googleapis.com/auth/youtube.upload（用于上传视频）
• https://www.googleapis.com/auth/youtube 或 https://www.googleapis.com/auth/youtube.force-ssl（用于更新视频权限）

2. 上传新视频时设置权限 #

使用videos.insert接口上传视频时，在请求体的status部分添加对应参数：

{
  "snippet": {
    "title": "你的会员专属视频标题",
    "description": "仅频道付费成员可观看",
    "tags": ["会员专属", "专属内容"]
  },
  "status": {
    "privacyStatus": "private",
    "membersOnly": true
  }
}

3. 更新已有视频权限 #

如果要修改已上传视频的权限，使用videos.update接口，指定part=status，并传入参数：

{
  "id": "你的视频ID",
  "status": {
    "privacyStatus": "private",
    "membersOnly": true
  }
}

注意事项 #

• 你的频道必须已开启频道会员计划（Channel Memberships），否则调用API时会返回权限错误。
• 设置完成后，视频的权限效果与在YouTube Studio中手动设置的「仅频道成员可见」完全一致。

内容的提问来源于stack exchange，提问作者Stefan