Captions

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

メソッド

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

list

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

insert

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

update

字幕トラックを更新します。字幕トラックを更新する際は、トラックの下書きステータスを変更したり、トラックの新しい字幕ファイルをアップロードしたり、その両方を行うことができます。 今すぐお試しください。

ダウンロード

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

delete

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

リソース表現

次の 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
  }
}

プロパティ

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