Ruby调用YouTube API上传视频默认私有 无法设置为公开/INTERNAL求助

1. 校验OAuth授权配置 #

• 确认授权时申请的权限范围包含https://www.googleapis.com/auth/youtube或https://www.googleapis.com/auth/youtube.upload，只读类权限无法修改视频隐私状态
• 清理本地缓存的旧授权Token，重新发起授权流程，确认授权时登录的账号为绑定了频道所有者权限的support@example.comWorkspace账号，避免误登个人谷歌账号
• 授权完成后调用如下代码验证目标频道是否正确：

  channels = service.list_channels('id,snippet', mine: true)
  puts channels.items.first.id # 确认返回的频道ID和你要上传的自有频道ID一致
  

2. 校验API请求参数构造 #

Ruby版本的Google::Apis::YoutubeV3库所有字段均为下划线命名，错误的参数嵌套或字段名会导致隐私状态配置被忽略，参考正确的构造示例：

# 构造视频对象
video = Google::Apis::YoutubeV3::Video.new(
  snippet: {
    title: "你的产品视频标题",
    description: "视频描述",
    tags: ["产品", "预览"]
  },
  status: {
    privacy_status: "public", # 公开状态传`public`，内部状态传`internal`
    embeddable: true,
    public_stats_viewable: true
  }
)
# 调用上传接口，必须指定`status`为返回/生效的part参数
response = service.insert_video(
  'snippet,status', 
  video, 
  upload_source: "本地视频文件路径.mp4", 
  content_type: "video/mp4"
)

重点注意：调用insert_video时第一个参数必须包含status，否则你设置的privacy_status不会生效。

3. 校验Workspace与频道配置 #

• 若要使用internal隐私状态，必须确认你的YouTube频道已经关联到所属Workspace组织，未关联组织的频道不支持INTERNAL状态，参数会被直接忽略
• 联系Workspace管理员检查后台配置：进入「应用」->「YouTube」->「频道权限设置」，确认已开启「允许频道所有者将视频设为公开」选项，未开启该选项时所有上传视频会被强制设为私有
• 进入YouTube频道后台的「设置」->「频道」->「状态和功能」，确认频道已完成手机号验证，未验证的新频道会被限制公开上传权限

4. 排查接口返回与平台限制 #

• 打印接口返回的完整响应与错误日志，若返回403 Forbidden则回到第一步检查权限，若返回invalidValue: privacyStatus则说明当前账号不支持你传入的隐私状态值
• 进入YouTube频道的「内容管理」页面，查看上传的视频是否触发了版权检测、内容审核，待审核的视频会默认保持私有状态，直到审核通过后才能修改为公开

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