Captions

caption リソースは、YouTube 字幕トラックを表します。字幕トラックは 1 つの YouTube 動画にのみ関連付けられます。

メソッド

この API は、captions リソースの次のメソッドをサポートしています。

list

指定した動画に関連付けられている字幕トラックのリストを取得します。なお、API レスポンスには実際の字幕は含まれず、captions.download メソッドには字幕トラックを取得する機能が用意されています。 今すぐお試しください。

insert

字幕トラックをアップロードします。

update

字幕トラックを更新します。字幕トラックを更新するときは、トラックのドラフト ステータスの変更、トラックの新しい字幕ファイルのアップロード、またはその両方を行うことができます。

delete

指定した字幕トラックを削除します。 今すぐ試す

ダウンロード

字幕トラックをダウンロードします。字幕トラックは、リクエストで tfmt パラメータの値を指定し、tlang パラメータの値を指定していない限り、元の言語で返されます。

リソース表現

次の JSON 構造は、captions リソースの形式を示しています。

{
  "kind": "youtube#caption",
  "etag": etag,
  "id": string,
  "snippet": {
    "videoId": string,
    "lastUpdated": datetime,
    "trackKind": string,
    "language": string,
    "name": string,
    "audioTrackType": string,
    "isCC": boolean,
    "isLarge": boolean,
    "isEasyReader": boolean,
    "isDraft": boolean,
    "isAutoSynced": boolean,
    "status": string,
    "failureReason": string
  }
}

プロパティ

次の表は、このリソースで使用されているプロパティの定義を示したものです。