通过API上传的YouTube字幕为何在YouTube Studio中不显示？

以下是针对API上传字幕在视频端可见但YouTube Studio不显示问题的排查和解决步骤：

• 检查snippet参数配置
  确保你构建的snippet对象包含正确的关键参数：

  • language必须用标准ISO 639-1语言代码（如zh-CN、en），不能用中文名称
  • isDraft要设为false，如果设为true，字幕只会出现在Studio的草稿字幕列表里，不会显示在正式管理栏
  • 确认videoId与目标视频完全匹配，避免误传到其他视频
    示例正确的snippet结构：

  snippet = {
      "videoId": "1GRgdwa_aS0",
      "language": "zh-CN",
      "name": "中文字幕",
      "isDraft": False
  }
  

• 验证授权权限范围
  确保你的应用授权时使用了足够的权限范围，推荐使用https://www.googleapis.com/auth/youtube.force-ssl，这个权限允许完整管理频道的字幕内容。如果之前使用了受限范围（如只读类权限），需要重新生成授权令牌，确保新权限生效。

• 检查字幕文件格式与编码
  确认上传的字幕文件和手动上传的版本完全一致：

  • 编码必须为UTF-8（无BOM），避免因编码问题导致Studio端无法解析
  • 文件格式需符合YouTube要求（如SRT、VTT、SBV），且无语法错误（比如时间轴格式错误、标签不规范）

• 排查后台同步异常
  虽然24小时已远超正常同步时长，但可以尝试在Studio中切换到其他频道再切回，或者刷新页面重试。如果以上配置都正确，可考虑提交YouTube开发者支持工单排查后台同步问题。

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