使用YouTube Captions API时，List接口获取的ID调用下载接口返回404

以下是几个可能导致你用字幕ID调用下载API返回404的原因及对应解决方法：

• 权限/认证缺失：
  能通过List接口获取字幕列表，不代表拥有下载权限。你需要确认在Google API Explorer中选择的OAuth 2.0 scope包含 https://www.googleapis.com/auth/youtubepartner 或 https://www.googleapis.com/auth/youtube.force-ssl。如果只使用了youtube.readonly这类只读权限，是无法下载字幕的。另外，还要检查认证账号是否有权限访问该视频的字幕——比如视频设置了隐私限制、地区限制，或者字幕仅对视频合作者开放，都会导致下载失败。

• 请求参数或路径错误：
  下载字幕的API请求必须指定字幕格式参数，比如alt=srt或alt=vtt。正确的请求URL格式应该是：

  GET https://www.googleapis.com/youtube/v3/captions/{captionId}?alt=srt
  

  如果遗漏了alt参数，或者路径拼写错误，服务器会返回404。

• 字幕/视频状态异常：
  尽管返回的字幕status为serving，但可能存在YouTube后台状态不同步的情况。另外，部分自动生成的字幕可能存在下载限制（不过你的返回中isAutoSynced为false，这条可能性较低）。可以先在YouTube网页端用同一账号尝试查看该视频的字幕，如果网页端也无法查看，说明是视频或字幕本身的权限/状态问题。

验证步骤 #

1. 重新在API Explorer中配置OAuth scope，勾选所需的下载权限后重新授权账号；
2. 构造完整的下载请求，确保包含alt参数；
3. 检查YouTube网页端的字幕访问权限，确认视频和字幕对当前账号开放。

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