Captions: download

下载字幕轨道。除非请求为 tfmt 参数及源语言指定值,否则系统会以原始格式返回字幕轨道;除非请求为 tlang 参数指定值。

配额影响:调用此方法的配额费用为 200 个单位。

常见使用场景

请求

HTTP 请求

GET https://www.googleapis.com/youtube/v3/captions/id

授权

此请求需要获得以下至少一个范围的授权(详细了解身份验证和授权)。

范围
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

参数

下表列出了此查询支持的参数。列出的所有参数都是查询参数。

参数
必需参数
id string
id 参数用于标识正在检索的字幕轨道。该值是由 caption 资源中的 id 属性标识的字幕轨道 ID。
可选参数
onBehalfOfContentOwner string
此参数只能在正确的授权请求中使用。注意:此参数专供 YouTube 内容合作伙伴使用。

onBehalfOfContentOwner 参数表示请求的授权凭据用于标识代表参数值中指定的内容所有者执行操作的 YouTube CMS 用户。此参数适用于拥有和管理许多不同 YouTube 频道的 YouTube 内容合作伙伴。内容所有者只需进行一次身份验证,即可访问自己所有的视频和频道数据,而无需为每个频道提供身份验证凭据。用户通过身份验证的实际 CMS 帐号必须与指定的 YouTube 内容所有者相关联。
tfmt string
tfmt 参数指定应以特定格式返回字幕轨道。如果请求中不包含该参数,则轨道将以其原始格式返回。

支持的值包括:
  • sbv - SubViewer 副标题
  • scc - 编剧字幕格式
  • srt - SubRip 副标题
  • ttml – 定时文本标记语言字幕
  • vtt - 网络视频文字字幕
tlang string
tlang 参数指定 API 响应应返回指定字幕轨道的译文。该参数值是 ISO 639-1 双字母语言代码,用于标识所需的字幕语言。翻译是通过谷歌翻译等机器翻译生成的。

请求正文

调用此方法时请勿提供请求正文。

响应

如果成功,此方法将返回二进制文件。响应的 Content-Type 标头为 application/octet-stream

错误

下表列出了该 API 为响应对此方法的调用可能返回的错误消息。如需了解详情,请参阅错误消息文档。

错误类型 错误详情 说明
forbidden (403) forbidden 与该请求关联的权限不足以下载字幕轨道。此请求可能未正确授权,或者视频订单可能不允许第三方为此字幕提供字幕。
invalidValue (400) couldNotConvert 字幕轨道数据无法转换为请求的语言和/或格式。请确保请求的 tfmttlang 值有效,并且所请求的字幕轨道的 snippet.status 不是 failed
notFound (404) captionNotFound 找不到字幕轨道。请检查请求的 id 参数的值,确保其正确无误。

试试看!

使用 APIs Explorer 调用此 API,并查看 API 请求和响应。