Youtube Data API v3 Captions下载功能故障求助

针对你遇到的自有视频字幕下载404问题，可按以下步骤逐一排查：

• 确认OAuth权限范围
  下载自有字幕必须使用包含https://www.googleapis.com/auth/youtube.force-ssl或https://www.googleapis.com/auth/youtube的权限范围。如果之前授权时用了更窄的范围（比如只读公开数据的权限），会导致API拒绝访问，需重新生成OAuth令牌并选择正确的权限。

• 验证字幕状态
  通过captions.list接口请求时添加part=status参数，检查目标字幕ID对应的status字段是否为active。如果字幕处于草稿、未发布状态，API会返回404，而第三方工具可能绕过状态检测直接抓取。

• 修正请求URL格式
  下载接口的正确路径应为https://www.googleapis.com/youtube/v3/captions/{captionId}，参数通过查询字符串传递：

  GET https://www.googleapis.com/youtube/v3/captions/AUieDaaebuQ4e7334VHqXqIIEiYfJI7IQAkJp0U6tO_7PSv0dao?tfmt=srt
  

  注意：使用OAuth认证时，需在请求头中携带Authorization: Bearer {你的OAuth令牌}，不要同时混用API Key和OAuth令牌，避免权限冲突。

• 检查视频隐私设置
  若视频为私有或未列出状态，仅API Key无法访问内容，必须使用对应频道所有者账号生成的OAuth令牌发起请求。API Key仅适用于公开视频的访问。

• 简化请求测试
  先去掉tlang等非必要参数，仅保留tfmt=srt，甚至先不指定格式，直接请求原始字幕数据。部分情况下，参数组合错误会触发404错误。

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