Videos

2020 年 7 月 28 日以降に作成された未確認の API プロジェクトから videos.insert エンドポイント経由でアップロードされたすべての動画は、非公開視聴モードに制限されます。この制限を解除するには、各 API プロジェクトで 利用規約の遵守状況を確認するための監査を受ける必要があります。詳しくは、API の変更履歴をご覧ください。

video リソースは YouTube 動画を表します。

メソッド

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

getRating

指定された動画のリストに対して、認証済みユーザーが付けた評価を取得します。今すぐ試す

list

API リクエスト パラメータに一致する動画のリストを返します。今すぐ試す

batchGetStats

API リクエスト パラメータに一致する動画統計情報のリストを取得します。今すぐ試す

insert

YouTube に動画をアップロードし、必要に応じて動画のメタデータを設定します。

update

動画のメタデータを更新します。今すぐ試す

delete

YouTube 動画を削除します。今すぐ試す

rate

動画に高評価または低評価を追加するか、動画から評価を削除します。今すぐ試す

reportAbuse

不適切なコンテンツを含む動画を報告します。今すぐ試す

リソース表現

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

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

プロパティ

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

プロパティ
kind	string API リソースのタイプを識別します。値は youtube#video になります。
etag	etag このリソースの Etag。
id	string YouTube が動画を一意に識別するために使用する ID。
snippet	object snippet オブジェクトには、タイトル、説明、カテゴリなど、動画に関する基本的な詳細情報が含まれます。
snippet.publishedAt	datetime 動画が公開された日時。この時間は、動画がアップロードされた時間とは異なる場合があります。たとえば、動画が非公開動画としてアップロードされ、後で公開された場合、このプロパティには動画が公開された時刻が指定されます。 いくつかの特殊なケースがあります。 動画が非公開動画としてアップロードされ、動画のメタデータがチャンネル所有者によって取得された場合、プロパティ値は動画がアップロードされた日時を指定します。 動画が限定公開動画としてアップロードされた場合、プロパティ値には動画がアップロードされた日時も指定されます。この場合、動画の固有の動画 ID を知っているユーザーは誰でも動画のメタデータを取得できます。 値は ISO 8601 形式で指定します。
snippet.channelId	string 動画がアップロードされたチャンネルを一意に識別するために YouTube が使用する ID。
snippet.title	string 動画のタイトル。プロパティ値の最大長は 100 文字で、< と > 以外のすべての有効な UTF-8 文字を含めることができます。videos.update メソッドを呼び出して video リソースの snippet 部分を更新する場合は、このプロパティの値を設定する必要があります。
snippet.description	string 動画の説明。プロパティ値の最大長は 5,000 バイトです。< と > 以外のすべての有効な UTF-8 文字を含めることができます。
snippet.thumbnails	object 動画に関連付けられたサムネイル画像のマップ。マップ内の各オブジェクトでは、キーはサムネイル画像の名前で、値はサムネイルに関するその他の情報を含むオブジェクトになります。
snippet.thumbnails.(key)	object 有効なキー値は次のとおりです。 default - デフォルトのサムネイル画像。動画（または、再生リストのアイテムや検索結果など、動画を参照するリソース）のデフォルト サムネイルは幅 120px、高さ 90px です。チャンネルのデフォルト サムネイルは幅 88px、高さ 88px です。 medium - サムネイル画像の高解像度版。動画（または動画を参照するリソース）の場合、この画像は幅 320px、高さ 180px です。チャンネルの場合は、幅 240px、高さ 240px です。 high - サムネイル画像の高解像度版。動画（または動画を参照するリソース）の場合、この画像は幅 480px、高さ 360px です。チャンネルの場合、幅 800px、高さ 800px です。 standard - high 解像度の画像よりもさらに高解像度のサムネイル画像。この画像は、一部の動画や、動画を参照する他のリソース（プレイリスト アイテムや検索結果など）で利用できます。この画像の幅は 640 ピクセル、高さは 480 ピクセルです。 maxres - サムネイル画像の最高解像度バージョン。この画像サイズは、一部の動画や、動画を参照する他のリソース（再生リスト アイテムや検索結果など）で利用できます。この画像のサイズは幅 1,280 ピクセル、高さ 720 ピクセルです。
snippet.thumbnails.(key).url	string 画像の URL。
snippet.thumbnails.(key).width	unsigned integer 画像の幅。
snippet.thumbnails.(key).height	unsigned integer 画像の高さ。
snippet.channelTitle	string 動画が属するチャンネルのチャンネル タイトル。
snippet.tags[]	list 動画に関連付けられているキーワード タグのリスト。タグにはスペースを含めることができます。プロパティ値の最大長は 500 文字です。文字数の上限の計算方法に関する次のルールに注意してください。 プロパティ値はリストであり、リスト内のアイテム間のカンマは上限にカウントされます。 タグにスペースが含まれている場合、API サーバーはタグ値を引用符で囲まれたものとして処理します。引用符は文字数制限にカウントされます。したがって、文字数制限の目的では、タグ Foo-Baz には 7 文字が含まれ、タグ Foo Baz には 9 文字が含まれます。
snippet.categoryId	string 動画に関連付けられている YouTube の動画カテゴリ。videos.update メソッドを呼び出して video リソースの snippet 部分を更新する場合は、このプロパティの値を設定する必要があります。
snippet.liveBroadcastContent	string 動画が今後のライブ配信またはライブ配信中かどうかを示します。動画が近日公開またはライブ配信中のライブブロードキャストでない場合、値は none です。 このプロパティの有効な値は次のとおりです。 live none upcoming
snippet.defaultLanguage	string video リソースの snippet.title プロパティと snippet.description プロパティのテキストの言語。
snippet.localized	object snippet.localized オブジェクトには、動画のローカライズされたタイトルと説明、または動画のメタデータのデフォルト言語のタイトルが含まれます。 videos.list リクエストで hl パラメータを使用してローカライズされたテキストを返す言語を指定し、かつその言語でローカライズされたテキストが利用可能な場合、ローカライズされたテキストがリソース スニペットで返されます。 hl パラメータ値が指定されていない場合、または値が指定されているが、指定された言語のローカライズされたメタデータが利用できない場合は、デフォルト言語のメタデータが返されます。 このプロパティには読み取り専用の値が含まれています。localizations オブジェクトを使用して、ローカライズされたタイトルを追加、更新、削除します。
snippet.localized.title	string ローカライズされた動画のタイトル。
snippet.localized.description	string ローカライズされた動画の説明。
snippet.defaultAudioLanguage	string default_audio_language プロパティは、動画のデフォルトの音声トラックで使用されている言語を指定します。
contentDetails	object contentDetails オブジェクトには、動画の長さや、動画で字幕を利用できるかどうかを示す情報など、動画コンテンツに関する情報が含まれます。
contentDetails.duration	string 動画の長さ。プロパティ値は ISO 8601 の期間です。たとえば、1 分以上 1 時間未満の動画の場合、期間は PT#M#S 形式になります。ここで、PT は値が期間を指定することを示し、M と S はそれぞれ分と秒の長さを表します。M と S の前の # は、動画の分（または秒）数を指定する整数です。たとえば、値 PT15M33S は、動画の長さが 15 分 33 秒であることを示します。 動画の長さが 1 時間以上の場合、期間は PT#H#M#S 形式になります。ここで、H の前の # は動画の長さを時間単位で指定し、その他の詳細は上記のとおりです。動画の長さが 1 日以上の場合、P と T は区切られ、値の形式は P#DT#H#M#S になります。詳細については、ISO 8601 仕様を参照してください。
contentDetails.dimension	string 動画が 3D で利用可能かどうかを示します。
contentDetails.definition	string 動画を高画質（HD）で視聴できるか、標準画質のみで視聴できるかを示します。 このプロパティの有効な値は次のとおりです。 hd sd
contentDetails.caption	string 動画の字幕が利用可能かどうかを示します。 このプロパティの有効な値は次のとおりです。 false true
contentDetails.licensedContent	boolean 動画がライセンス コンテンツを表しているかどうかを示します。ライセンス コンテンツとは、YouTube コンテンツ パートナーにリンクされているチャンネルにアップロードされ、そのパートナーによって申し立てられたコンテンツのことです。
contentDetails.regionRestriction	object regionRestriction オブジェクトには、動画を視聴できる（または視聴できない）国に関する情報が含まれます。オブジェクトには contentDetails.regionRestriction.allowed プロパティまたは contentDetails.regionRestriction.blocked プロパティのいずれかが含まれます。
contentDetails.regionRestriction.allowed[]	list 動画を視聴できる国を特定する地域コードのリスト。このプロパティが指定されている場合、値にリストされていない国では、その動画の表示がブロックされます。このプロパティが指定されていて、リストが空の場合、動画はすべての国でブロックされます。
contentDetails.regionRestriction.blocked[]	list 動画がブロックされている国を特定するリージョン コードのリスト。このプロパティが指定されている場合、値にリストされていない国では、その動画を視聴できます。このプロパティが指定されていて、リストが空の場合、動画はすべての国で視聴可能です。
contentDetails.contentRating	object さまざまなレーティング スキームで動画に付与されたレーティングを指定します。
contentDetails.contentRating.acbRating	string 動画のオーストラリア等級審査委員会（ACB）またはオーストラリア通信メディア庁（ACMA）のレーティング。ACMA のレーティングは、子供向けのテレビ番組を分類するために使用されます。 このプロパティの有効な値は次のとおりです。 acbC - オーストラリア通信メディア庁によって C の分類が与えられた番組。これらの番組は、14 歳未満のお子様（就学前のお子様を除く）向けです。 acbE – E acbG – G acbM - M acbMa15plus - MA15+ acbP - オーストラリア通信メディア庁によって P の分類が与えられた番組。これらの番組は就学前のお子様を対象としています。 acbPg - PG acbR18plus - R18+ acbUnrated
contentDetails.contentRating.agcomRating	string イタリアの通信保証庁（AGCOM）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 agcomT - T agcomUnrated agcomVm14 - VM14 agcomVm18 - VM18
contentDetails.contentRating.anatelRating	string チリのテレビ番組に対する Anatel（Asociación Nacional de Televisión）のレーティング。 このプロパティの有効な値は次のとおりです。 anatelA – A anatelF – F anatelI - I anatelI10 – I-10 anatelI12 – I-12 anatelI7 – I-7 anatelR - R anatelUnrated
contentDetails.contentRating.bbfcRating	string 動画の British Board of Film Classification（BBFC）レーティング。 このプロパティの有効な値は次のとおりです。 bbfc12 – 12 bbfc12a - 12A bbfc15 – 15 bbfc18 – 18 bbfcPg - PG bbfcR18 - R18 bbfcU - U bbfcUnrated
contentDetails.contentRating.bfvcRating	string タイの映画およびビデオ検閲委員会による動画のレーティング。 このプロパティの有効な値は次のとおりです。 bfvc13 – 13 bfvc15 – 15 bfvc18 – 18 bfvc20 – 20 bfvcB – B bfvcE – E bfvcG – G bfvcUnrated
contentDetails.contentRating.bmukkRating	string オーストリアのメディア分類委員会（Bundesministerium für Unterricht, Kunst und Kultur）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 bmukk10 – 10+ bmukk12 – 12+ bmukk14 – 14+ bmukk16 - 16+ bmukk6 – 6+ bmukk8 – 8+ bmukkAa - 制限なし bmukkUnrated
contentDetails.contentRating.catvRating	string カナダのテレビのレーティング システム - カナダのテレビ分類システム。カナダの英語放送に関するカナダのラジオテレビ通信委員会（CRTC）による動画のレーティング。詳しくは、カナダ放送基準協議会のウェブサイトをご覧ください。 このプロパティの有効な値は次のとおりです。 catv14plus – 14+ catv18plus - 18 歳以上 catvC – C catvC8 – C8 catvG – G catvPg - PG catvUnrated
contentDetails.contentRating.catvfrRating	string カナダのフランス語放送に関するカナダのラジオテレビ通信委員会（CRTC）の動画のレーティング。詳しくは、カナダ放送基準協議会のウェブサイトをご覧ください。 このプロパティの有効な値は次のとおりです。 catvfr13plus – 13+ catvfr16plus - 16 歳以上 catvfr18plus - 18 歳以上 catvfr8plus – 8+ catvfrG – G catvfrUnrated
contentDetails.contentRating.cbfcRating	string 動画の映画中央認証委員会（CBFC - インド）のレーティング。 このプロパティの有効な値は次のとおりです。 cbfcA – A cbfcS - S cbfcU - U cbfcUnrated cbfcUA - U/A cbfcUA7plus - U/A cbfcUA13plus - U/A cbfcUA16plus - U/A
contentDetails.contentRating.cccRating	string 動画の Consejo de Calificación Cinematográfica（チリ）のレーティング。 このプロパティの有効な値は次のとおりです。 ccc14 – 14+ ccc18 - 18 歳以上 ccc18s - 18+ - contenido pornográfico ccc18v - 18+ - contenido excesivamente violento ccc6 – 6+ - Inconveniente para menores de 7 años cccTe - Todo espectador cccUnrated
contentDetails.contentRating.cceRating	string ポルトガルの Comissão de Classificação de Espect´culos による動画のレーティング。 このプロパティの有効な値は次のとおりです。 cceM12 – 12 cceM14 – 14 cceM16 – 16 cceM18 – 18 cceM4 – 4 cceM6 – 6 cceUnrated
contentDetails.contentRating.chfilmRating	string スイスでの動画のレーティング。 このプロパティの有効な値は次のとおりです。 chfilm0 – 0 chfilm12 – 12 chfilm16 – 16 chfilm18 – 18 chfilm6 – 6 chfilmUnrated
contentDetails.contentRating.chvrsRating	string 動画のカナダのホーム ビデオ レーティング システム（CHVRS）のレーティング。 このプロパティの有効な値は次のとおりです。 chvrs14a – 14A chvrs18a - 18A chvrsE – E chvrsG – G chvrsPg - PG chvrsR - R chvrsUnrated
contentDetails.contentRating.cicfRating	string ベルギーの Commission de Contrôle des Films による動画のレーティング。 このプロパティの有効な値は次のとおりです。 cicfE – E cicfKntEna - KNT/ENA cicfKtEa - KT/EA cicfUnrated
contentDetails.contentRating.cnaRating	string ルーマニアの CONSILIUL NATIONAL AL AUDIOVIZUALULUI（CNA）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 cna12 – 12 cna15 – 15 cna18 – 18 cna18plus - 18 歳以上 cnaAp - AP cnaUnrated
contentDetails.contentRating.cncRating	string フランスのレーティング システム - Commission de classification cinematographique このプロパティの有効な値は次のとおりです。 cnc10 – 10 cnc12 – 12 cnc16 – 16 cnc18 – 18 cncE – E cncT - T cncUnrated
contentDetails.contentRating.csaRating	string 放送コンテンツを評価するフランスの Conseil supérieur de l'audiovisuel による動画のレーティング。 このプロパティの有効な値は次のとおりです。 csa10 – 10 csa12 – 12 csa16 – 16 csa18 – 18 csaInterdiction - 阻止 csaT - T csaUnrated
contentDetails.contentRating.cscfRating	string ルクセンブルクの Commission de surveillance de la classification des films（CSCF）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 cscf12 – 12 cscf16 – 16 cscf18 – 18 cscf6 – 6 cscf9 – 9 cscfA – A cscfAl - AL cscfUnrated
contentDetails.contentRating.czfilmRating	string チェコ共和国での動画のレーティング。 このプロパティの有効な値は次のとおりです。 czfilm12 – 12 czfilm14 – 14 czfilm18 – 18 czfilmU - U czfilmUnrated
contentDetails.contentRating.djctqRating	string 動画の Departamento de Justiça, Classificação, Qualificação e Títulos（DJCQT - ブラジル）のレーティング。 このプロパティの有効な値は次のとおりです。 djctq10 – 10 djctq12 – 12 djctq14 – 14 djctq16 – 16 djctq18 – 18 djctqL – L djctqUnrated
contentDetails.contentRating.djctqRatingReasons[]	list 動画に DJCQT（ブラジル）のレーティングが付与された理由。
contentDetails.contentRating.ecbmctRating	string トルコのレーティング システム - 文化観光省の評価分類委員会 このプロパティの有効な値は次のとおりです。 ecbmct13a – 13A ecbmct13plus - 13+ ecbmct15a - 15A ecbmct15plus – 15+ ecbmct18plus - 18 歳以上 ecbmct7a - 7A ecbmct7plus – 7+ ecbmctG – G ecbmctUnrated ecbmct6a - 6A ecbmct6plus – 6+ ecbmct10a – 10A ecbmct10plus – 10+ ecbmct16plus - 16+
contentDetails.contentRating.eefilmRating	string エストニアでの動画のレーティング。 このプロパティの有効な値は次のとおりです。 eefilmK12 - K-12 eefilmK14 - K-14 eefilmK16 - K-16 eefilmK6 – K-6 eefilmL – L eefilmMs12 – MS-12 eefilmMs6 – MS-6 eefilmPere – Pere eefilmUnrated
contentDetails.contentRating.egfilmRating	string エジプトでの動画のレーティング。 このプロパティの有効な値は次のとおりです。 egfilm18 – 18 egfilmBn – BN egfilmGn – GN egfilmUnrated
contentDetails.contentRating.eirinRating	string 動画の映倫（映倫）レーティング。映倫は日本のレーティング システムです。 このプロパティの有効な値は次のとおりです。 eirinG – G eirinPg12 - PG-12 eirinR15plus - R15+ eirinR18plus - R18+ eirinUnrated
contentDetails.contentRating.fcbmRating	string マレーシアの映画検閲委員会による動画のレーティング。 このプロパティの有効な値は次のとおりです。 fcbm13 – 13 fcbm16 – 16 fcbm18 – 18 fcbm18pa - 18PA fcbm18pl - 18PL fcbm18sg – 18SG fcbm18sx – 18SX fcbmP12 - P12 fcbmP13 – P13 fcbmPg13 - PG13 fcbmU - U fcbmUnrated
contentDetails.contentRating.fcoRating	string 香港の映画新聞記事管理局による動画のレーティング。 このプロパティの有効な値は次のとおりです。 fcoI - I fcoIi – II fcoIia - IIA fcoIib - IIB fcoIii – III fcoUnrated
contentDetails.contentRating.fmocRating	string このプロパティは、2015 年 11 月 2 日をもって非推奨となりました。代わりに contentDetails.contentRating.cncRating プロパティを使用してください。 動画の Centre national du cinéma et de l'image animé（フランス文化省）のレーティング。 このプロパティの有効な値は次のとおりです。 fmoc10 – 10 fmoc12 – 12 fmoc16 – 16 fmoc18 – 18 fmocE – E fmocU - U fmocUnrated
contentDetails.contentRating.fpbRating	string 南アフリカの映画出版委員会による動画のレーティング。 このプロパティの有効な値は次のとおりです。 fpb10 – 10 fpb1012Pg – 10-12PG fpb13 – 13 fpb16 – 16 fpb18 – 18 fpb79Pg – 7-9PG fpbA – A fpbPg - PG fpbUnrated fpbX18 - X18 fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[]	list 動画に FPB（南アフリカ）のレーティングが付与された理由を説明します。
contentDetails.contentRating.fskRating	string 動画の Freiwillige Selbstkontrolle der Filmwirtschaft（FSK - ドイツ）のレーティング。 このプロパティの有効な値は次のとおりです。 fsk0 - FSK 0 fsk12 - FSK 12 fsk16 - FSK 16 fsk18 - FSK 18 fsk6 - FSK 6 fskUnrated
contentDetails.contentRating.grfilmRating	string ギリシャでの動画のレーティング。 このプロパティの有効な値は次のとおりです。 grfilmE – E grfilmK – K grfilmK12 - K-12 grfilmK13 - K-13 grfilmK15 – K-15 grfilmK17 – K-17 grfilmK18 - K-18 grfilmUnrated
contentDetails.contentRating.icaaRating	string 動画の Instituto de la Cinematografía y de las Artes Audiovisuales（ICAA - スペイン）のレーティング。 このプロパティの有効な値は次のとおりです。 icaa12 – 12 icaa13 – 13 icaa16 – 16 icaa18 – 18 icaa7 – 7 icaaApta – APTA icaaUnrated icaaX - X
contentDetails.contentRating.ifcoRating	string 動画の Irish Film Classification Office（IFCO - アイルランド）のレーティング。詳細については、IFCO のウェブサイトをご覧ください。 このプロパティの有効な値は次のとおりです。 ifco12 – 12 ifco12a - 12A ifco15 – 15 ifco15a - 15A ifco16 – 16 ifco18 – 18 ifcoG – G ifcoPg - PG ifcoUnrated
contentDetails.contentRating.ilfilmRating	string イスラエルでの動画のレーティング。 このプロパティの有効な値は次のとおりです。 ilfilm12 – 12 ilfilm16 – 16 ilfilm18 – 18 ilfilmAa - AA ilfilmUnrated
contentDetails.contentRating.incaaRating	string 動画の INCAA（アルゼンチン国立映画映像芸術研究所）のレーティング。 このプロパティの有効な値は次のとおりです。 incaaAtp - ATP（Apta para todo publico） incaaC - X（18 歳以上のみ対象、条件付き上映） incaaSam13 – 13 (Solo apta para mayores de 13 años) incaaSam16 – 16（16 歳以上のみ対象） incaaSam18 – 18（18 歳以上のみ対象） incaaUnrated
contentDetails.contentRating.kfcbRating	string ケニア映画分類委員会による動画のレーティング。 このプロパティの有効な値は次のとおりです。 kfcb16plus – 16 kfcbG – GE kfcbPg - PG kfcbR – 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media（オランダ）。 このプロパティの有効な値は次のとおりです。 kijkwijzer12 – 12 kijkwijzer14 – 14 kijkwijzer16 – 16 kijkwijzer18 – 18 kijkwijzer6 – 6 kijkwijzer9 – 9 kijkwijzerAl - AL kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	string 動画の韓国映像物等級委員会（영상물등급위원회）のレーティング。KMRB は韓国の動画をレーティングします。 このプロパティの有効な値は次のとおりです。 kmrb12plus – 12세 이상 관람가 kmrb15plus – 15세 이상 관람가 kmrbAll – 전체관람가 kmrbR - 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string インドネシアの Lembaga Sensor Film による動画のレーティング。 このプロパティの有効な値は次のとおりです。 lsf13 – 13 lsf17 – 17 lsf21 – 21 lsfA – A lsfBo - BO lsfD - D lsfR - R lsfSu - SU lsfUnrated
contentDetails.contentRating.mccaaRating	string マルタの映画年齢分類委員会による動画のレーティング。 このプロパティの有効な値は次のとおりです。 mccaa12 – 12 mccaa12a - 12A mccaa14 - 14 - このレーティングは、2013 年に導入された新しい分類構造から削除されました。 mccaa15 – 15 mccaa16 - 16 - このレーティングは、2013 年に導入された新しい分類構造から削除されました。 mccaa18 – 18 mccaaPg - PG mccaaU - U mccaaUnrated
contentDetails.contentRating.mccypRating	string デンマーク映画協会（Det Danske Filminstitut）の児童青少年メディア評議会による動画のレーティング。 このプロパティの有効な値は次のとおりです。 mccyp11 – 11 mccyp15 – 15 mccyp7 – 7 mccypA – A mccypUnrated
contentDetails.contentRating.mcstRating	string ベトナムの動画のレーティング システム - MCST このプロパティの有効な値は次のとおりです。 mcst0 – 0 mcst16plus - 16+ mcstC13 – C13 mcstC16 - C16 mcstC18 – C18 mcstP - P mcstUnrated mcstT13 - T13 mcstT16 - T16 mcstT18 – T18 mcstK – K
contentDetails.contentRating.mdaRating	string シンガポールの Media Development Authority（MDA）、特に Board of Film Censors（BFC）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 mdaG – G mdaM18 - M18 mdaNc16 - NC16 mdaPg - PG mdaPg13 - PG13 mdaR21 – R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string ノルウェーのメディア規制機関である Medietilsynet による動画のレーティング。 このプロパティの有効な値は次のとおりです。 medietilsynet11 – 11 medietilsynet12 – 12 medietilsynet15 – 15 medietilsynet18 – 18 medietilsynet6 – 6 medietilsynet7 – 7 medietilsynet9 – 9 medietilsynetA – A medietilsynetUnrated
contentDetails.contentRating.mekuRating	string フィンランドの Kansallinen Audiovisuaalinen Instituutti（国立視聴覚研究所）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 meku12 – 12 meku16 – 16 meku18 – 18 meku7 – 7 mekuS - S mekuUnrated
contentDetails.contentRating.mibacRating	string イタリア文化観光省による動画のレーティング。 このプロパティの有効な値は次のとおりです。 mibacT mibacUnrated mibacVap mibacVm6 mibacVm12 mibacVm14 mibacVm18
contentDetails.contentRating.mocRating	string 動画の Ministerio de Cultura（コロンビア）のレーティング。 このプロパティの有効な値は次のとおりです。 moc12 – 12 moc15 – 15 moc18 – 18 moc7 – 7 mocBanned - 禁止 mocE – E mocT - T mocUnrated mocX - X
contentDetails.contentRating.moctwRating	string 台湾の文化部（文化部）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 moctwG – G moctwP - P moctwPg - PG moctwR - R moctwR12 – R-12 moctwR15 - R-15 moctwUnrated
contentDetails.contentRating.mpaaRating	string 動画のアメリカ映画協会（MPAA）のレーティング。 このプロパティの有効な値は次のとおりです。 mpaaG – G mpaaNc17 - NC-17 mpaaPg - PG mpaaPg13 - PG-13 mpaaR - R mpaaUnrated
contentDetails.contentRating.mpaatRating	string 映画の予告編とプレビューに対するアメリカ映画協会のレーティング。 このプロパティの有効な値は次のとおりです。 mpaatGb - GB（グリーン バンド - すべてのユーザーにご利用いただけます） mpaatRb - RB（レッドバンド - 17 歳以上におすすめ）
contentDetails.contentRating.mtrcbRating	string 映画とテレビの審査分類委員会（フィリピン）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 mtrcbG – G mtrcbPg - PG mtrcbR13 – R-13 mtrcbR16 – R-16 mtrcbR18 - R-18 mtrcbUnrated mtrcbX - X
contentDetails.contentRating.nbcRating	string モルディブ国立分類局による動画のレーティング。 このプロパティの有効な値は次のとおりです。 nbc12plus – 12+ nbc15plus – 15+ nbc18plus - 18 歳以上 nbc18plusr - 18+R nbcG – G nbcPg - PG nbcPu - PU nbcUnrated
contentDetails.contentRating.nfrcRating	string ブルガリア国立映画センターによる動画のレーティング。 このプロパティの有効な値は次のとおりです。 nfrcA – A nfrcB – B nfrcC – C nfrcD - D nfrcUnrated nfrcX - X
contentDetails.contentRating.nfvcbRating	string ナイジェリアの National Film and Video Censors Board による動画のレーティング。 このプロパティの有効な値は次のとおりです。 nfvcb12 – 12 nfvcb12a - 12A nfvcb15 – 15 nfvcb18 – 18 nfvcbG – G nfvcbPg - PG nfvcbRe - RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string ラトビア国立映画センターによる動画のレーティング。 このプロパティの有効な値は次のとおりです。 nkclv12plus – 12+ nkclv18plus - 18 歳以上 nkclv7plus – 7+ nkclvU - U nkclvUnrated
contentDetails.contentRating.oflcRating	string 動画の映画文学分類局（OFLC - ニュージーランド）のレーティング。 このプロパティの有効な値は次のとおりです。 oflcG – G oflcM - M oflcPg - PG oflcR13 – R13 oflcR15 - R15 oflcR16 – R16 oflcR18 - R18 oflcRp13 - RP13 oflcRp16 – RP16 oflcUnrated
contentDetails.contentRating.pefilmRating	string ペルーでの動画のレーティング。 このプロパティの有効な値は次のとおりです。 pefilm14 – 14 pefilm18 – 18 pefilmPg - PG pefilmPt - PT pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating	string ベネズエラの動画のレーティング。 このプロパティの有効な値は次のとおりです。 resorteviolenciaA – A resorteviolenciaB – B resorteviolenciaC – C resorteviolenciaD - D resorteviolenciaE – E resorteviolenciaUnrated
contentDetails.contentRating.rtcRating	string 動画のメキシコ放送映画総局のレーティング。 このプロパティの有効な値は次のとおりです。 rtcA – A rtcAa - AA rtcB – B rtcB15 - B15 rtcC – C rtcD - D rtcUnrated
contentDetails.contentRating.rteRating	string アイルランドの Raidió Teilifís Éireann による動画のレーティング。 このプロパティの有効な値は次のとおりです。 rteCh – CH rteGa - 一般提供 rteMa - MA rtePs – PS rteUnrated
contentDetails.contentRating.russiaRating	string 動画のロシア連邦国立映画登録簿（MKRF - ロシア）のレーティング。 このプロパティの有効な値は次のとおりです。 russia0 – 0+ russia12 – 12+ russia16 - 16+ russia18 - 18 歳以上 russia6 – 6+ russiaUnrated
contentDetails.contentRating.skfilmRating	string スロバキアでの動画のレーティング。 このプロパティの有効な値は次のとおりです。 skfilmG – G skfilmP2 - P2 skfilmP5 - P5 skfilmP8 - P8 skfilmUnrated
contentDetails.contentRating.smaisRating	string アイスランドでの動画のレーティング。 このプロパティの有効な値は次のとおりです。 smais12 – 12 smais14 – 14 smais16 – 16 smais18 – 18 smais7 – 7 smaisL – L smaisUnrated
contentDetails.contentRating.smsaRating	string Statens medieråd（スウェーデンの国立メディア評議会）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 smsa11 – 11 smsa15 – 15 smsa7 – 7 smsaA - 全年齢対象 smsaUnrated
contentDetails.contentRating.tvpgRating	string 動画の TV Parental Guidelines（TVPG）レーティング。 このプロパティの有効な値は次のとおりです。 tvpgG - TV-G tvpgMa - TV-MA tvpgPg - TV-PG tvpgUnrated tvpgY - TV-Y tvpgY7 - TV-Y7 tvpgY7Fv - TV-Y7-FV pg14 - TV-14
contentDetails.contentRating.ytRating	string YouTube が年齢制限のあるコンテンツを識別するために使用するレーティング。 このプロパティの有効な値は次のとおりです。 ytAgeRestricted
contentDetails.projection	string 動画のプロジェクション形式を指定します。 このプロパティの有効な値は次のとおりです。 360 rectangular
contentDetails.hasCustomThumbnail	boolean 動画のアップロード者が動画のカスタム サムネイル画像を提供しているかどうかを示します。このプロパティは、動画のアップロード担当者のみに表示されます。
status	object status オブジェクトには、動画のアップロード、処理、プライバシーのステータスに関する情報が含まれます。
status.uploadStatus	string アップロードされた動画のステータス。 このプロパティの有効な値は次のとおりです。 deleted failed processed rejected uploaded
status.failureReason	string この値は、動画のアップロードに失敗した理由を示します。このプロパティは、uploadStatus プロパティがアップロードの失敗を示している場合にのみ存在します。 このプロパティの有効な値は次のとおりです。 codec conversion emptyFile invalidFile tooSmall uploadAborted
status.rejectionReason	string この値は、YouTube がアップロードされた動画を拒否した理由を示します。このプロパティは、uploadStatus プロパティがアップロードが拒否されたことを示している場合にのみ存在します。 このプロパティの有効な値は次のとおりです。 claim copyright duplicate inappropriate legal length termsOfUse trademark uploaderAccountClosed uploaderAccountSuspended
status.privacyStatus	string 動画のプライバシー ステータス。 このプロパティの有効な値は次のとおりです。 private public unlisted
status.publishAt	datetime 動画の公開予定日時。動画のプライバシー ステータスが非公開の場合にのみ設定できます。値は ISO 8601 形式で指定します。このプロパティの動作については、次の 2 つの点にも注意してください。 videos.update メソッドの呼び出し時にこのプロパティの値を設定する場合は、動画がすでに非公開であっても、status.privacyStatus プロパティの値を private に設定する必要があります。 このプロパティは、動画のプライバシー ステータスが private で、動画が一度も公開されていない場合にのみ設定できます。 リクエストで過去の時刻に動画を公開するようにスケジュール設定した場合、動画はすぐに公開されます。そのため、status.publishAt プロパティを過去の日時に設定する効果は、動画の privacyStatus を private から public に変更する効果と同じです。
status.license	string 動画のライセンス。 このプロパティの有効な値は次のとおりです。 creativeCommon youtube
status.embeddable	boolean この値は、動画を他のウェブサイトに埋め込めるかどうかを示します。
status.publicStatsViewable	boolean この値は、動画の動画再生ページの拡張動画統計情報を一般公開するかどうかを示します。デフォルトでは、これらの統計情報は表示可能であり、このプロパティの値が false に設定されている場合でも、動画の視聴回数や評価などの統計情報は引き続き一般公開されます。
status.madeForKids	boolean この値は、動画が子ども向けに指定されているかどうかを示し、動画の現在の「子ども向け」ステータスが含まれます。たとえば、ステータスは selfDeclaredMadeForKids プロパティの値に基づいて決定される場合があります。チャンネル、動画、ブロードキャストの視聴者設定について詳しくは、YouTube ヘルプセンターをご覧ください。
status.selfDeclaredMadeForKids	boolean videos.insert リクエストまたは videos.update リクエストでは、このプロパティを使用して、チャンネル所有者が動画を子ども向けとして指定できます。videos.list リクエストでは、チャンネル所有者が API リクエストを承認した場合にのみ、プロパティ値が返されます。
status.containsSyntheticMedia	boolean videos.insert リクエストまたは videos.update リクエストで、このプロパティを使用すると、チャンネル所有者は、動画にリアルな改変または合成（A/S）コンテンツが含まれていることを開示できます。A/S コンテンツに関連する YouTube のポリシーの詳細をご覧ください。 A/S コンテンツの例としては、次のような動画があります。 実在の人物が実際には発言または行動していないことを、発言または行動しているように見せている 実際の出来事や場所の映像を改変している 実際には起きていない場面が現実のように見えるコンテンツを生成している
statistics	object statistics オブジェクトには、動画に関する統計情報が含まれます。
statistics.viewCount	unsigned long 動画が再生された回数。 2025 年 3 月 31 日より、ショート動画の場合、viewCount はショート動画の再生または繰り返し再生が開始された回数を返します。最低視聴時間の要件はありません。
statistics.likeCount	unsigned long 動画を高く評価したユーザーの数。
statistics.dislikeCount	unsigned long 注釈: statistics.dislikeCount プロパティは、2021 年 12 月 13 日に非公開になりました。つまり、API リクエストが動画所有者によって認証された場合にのみ、このプロパティが API レスポンスに含まれます。詳しくは、変更履歴をご覧ください。 動画を低評価したユーザーの数。
statistics.favoriteCount	unsigned long 注: このプロパティは非推奨になりました。非推奨は 2015 年 8 月 28 日から有効です。プロパティの値は常に 0 に設定されるようになりました。
statistics.commentCount	unsigned long 動画のコメント数。
paidProductPlacementDetails	object paidProductPlacementDetails オブジェクトには、動画内の有料プロダクト プレースメントに関する情報が含まれます。
paidProductPlacementDetails.hasPaidProductPlacement	boolean コンテンツで有料プロダクト プレースメントを使用している場合は true に設定します。デフォルトは false です。
player	object player オブジェクトには、埋め込みプレーヤーで動画を再生するために使用する情報が含まれています。
player.embedHtml	string 動画を再生するプレーヤーを埋め込む <iframe> タグ。 リソースを取得する API リクエストで maxHeight パラメータまたは maxWidth パラメータの値を指定すると、埋め込みプレーヤーのサイズは maxHeight 要件または maxWidth 要件を満たすようにスケーリングされます。 動画のアスペクト比が不明な場合、埋め込みプレーヤーはデフォルトで 4:3 形式になります。
player.embedHeight	long player.embedHtml プロパティで返される埋め込みプレーヤーの高さ。このプロパティは、リクエストで maxHeight パラメータまたは maxWidth パラメータのいずれかまたは両方の値が指定され、動画のアスペクト比がわかっている場合にのみ返されます。
player.embedWidth	long player.embedHtml プロパティで返される埋め込みプレーヤーの幅。このプロパティは、リクエストで maxHeight パラメータまたは maxWidth パラメータのいずれかまたは両方の値が指定され、動画のアスペクト比がわかっている場合にのみ返されます。
topicDetails	object topicDetails オブジェクトは、動画に関連付けられたトピックに関する情報をカプセル化します。 重要: トピック ID に関連する今後の変更について詳しくは、topicDetails.relevantTopicIds[] プロパティと topicDetails.topicIds[] プロパティの定義と変更履歴をご覧ください。
topicDetails.topicIds[]	list 重要: このプロパティは 2016 年 11 月 10 日をもって非推奨となりました。このプロパティの値は API から返されなくなり、動画に関連付けられているトピックは topicDetails.relevantTopicIds[] プロパティ値で返されるようになりました。
topicDetails.relevantTopicIds[]	list 動画に関連するトピック ID のリスト。 このプロパティは 2016 年 11 月 10 日をもって非推奨となりました。サポートは 2017 年 11 月 10 日までとなります。 重要: Freebase と Freebase API のサポート終了に伴い、2017 年 2 月 27 日よりトピック ID の動作が変更されました。その時点で、YouTube は厳選されたトピック ID の小さなセットを返すようになりました。 2017 年 2 月 15 日時点でサポートされているトピック ID を参照してください トピック 音楽のトピック /m/04rlf 音楽（親トピック） /m/02mscn クリスチャン ミュージック /m/0ggq0m クラシック音楽 /m/01lyv 国 /m/02lkt エレクトロニック ミュージック /m/0glt670 ヒップホップ ミュージック /m/05rwpb インディーズ音楽 /m/03_d0 ジャズ /m/028sqc アジアの音楽 /m/0g293 ラテンアメリカの音楽 /m/064t9 ポップ ミュージック /m/06cqb レゲエ /m/06j6l リズム アンド ブルース /m/06by7 ロック ミュージック /m/0gywn ソウル ミュージック ゲームのトピック /m/0bzvm2 ゲーム（親トピック） /m/025zzc アクション ゲーム /m/02ntfj アクション アドベンチャー ゲーム /m/0b1vjn カジュアル ゲーム /m/02hygl 音楽ビデオゲーム /m/04q1x3q パズルゲーム /m/01sjng レーシング ビデオゲーム /m/0403l3g ロールプレイング テレビゲーム /m/021bp2 シミュレーション ゲーム /m/022dc6 スポーツゲーム /m/03hf_rm ストラテジー ビデオゲーム スポーツ トピック /m/06ntj スポーツ（親トピック） /m/0jm_ アメリカン フットボール /m/018jz 野球 /m/018w8 バスケットボール /m/01cgz ボクシング /m/09xp_ クリケット /m/02vx4 フットボール /m/037hz ゴルフ /m/03tmr アイスホッケー /m/01h7lh 総合格闘技 /m/0410tth モータースポーツ /m/07bs0 テニス /m/07_53 バレーボール エンターテイメント トピック /m/02jjt エンターテイメント（親トピック） /m/09kqc ユーモア /m/02vxn 映画 /m/05qjc 舞台芸術 /m/066wd プロレス /m/0f2f9 テレビ番組 ライフスタイル トピック /m/019_rr ライフスタイル（親トピック） /m/032tl ファッション /m/027x7n フィットネス /m/02wbm 食べ物 /m/03glg 趣味 /m/068hy ペット /m/041xxh 身体的魅力 [Beauty] /m/07c1v テクノロジー /m/07bxq 観光 /m/07yv9 乗り物 社会に関するトピック /m/098wr 社会（親トピック） /m/09s1f Business /m/0kt51 健康 /m/01h6rj 軍事 /m/05qt0 政治 /m/06bvp 宗教 その他のトピック /m/01k8wb 知識
topicDetails.topicCategories[]	list 動画の内容の概要を説明する Wikipedia の URL のリスト。
recordingDetails	object recordingDetails オブジェクトは、動画が記録された場所、日付、住所に関する情報をカプセル化します。
recordingDetails.locationDescription	string このプロパティは 2017 年 6 月 1 日をもって非推奨になりました。詳しくは、サポート終了のお知らせをご覧ください。 動画が撮影された場所のテキスト説明。
recordingDetails.location	object 動画に関連付けられた位置情報。子プロパティの値は、動画所有者が動画に関連付ける場所を識別します。この値は編集可能で、公開動画の場合は検索可能であり、公開動画の場合はユーザーに表示される可能性があります。
recordingDetails.location.latitude	double このプロパティは 2017 年 6 月 1 日をもって非推奨になりました。詳しくは、サポート終了のお知らせをご覧ください。 緯度（度単位）。
recordingDetails.location.longitude	double このプロパティは 2017 年 6 月 1 日をもって非推奨になりました。詳しくは、サポート終了のお知らせをご覧ください。 経度（度単位）。
recordingDetails.location.altitude	double このプロパティは 2018 年 7 月 9 日をもって非推奨になりました。詳しくは、サポート終了のお知らせをご覧ください。 基準楕円体からの高度（メートル単位）。
recordingDetails.recordingDate	datetime 動画が録画された日時。値は ISO 8601（YYYY-MM-DDThh:mm:ss.sssZ）形式で指定します。
fileDetails	object fileDetails オブジェクトには、YouTube にアップロードされた動画ファイルに関する情報（ファイルの解像度、再生時間、音声コーデックと動画コーデック、ストリーム ビットレートなど）がカプセル化されています。このデータを取得できるのは動画の所有者のみです。 fileDetails オブジェクトは、processingDetails.fileAvailability プロパティの値が available の場合にのみ返されます。
fileDetails.fileName	string アップロードされたファイルの名前。このフィールドは、アップロードされたのが動画ファイルか別のタイプのファイルかに関係なく存在します。
fileDetails.fileSize	unsigned long アップロードされたファイルのサイズ（バイト単位）。このフィールドは、アップロードされたのが動画ファイルか別のタイプのファイルかに関係なく存在します。
fileDetails.fileType	string YouTube の動画処理エンジンによって検出された、アップロードされたファイルのタイプ。現在、YouTube で処理されるのは動画ファイルのみですが、動画ファイル以外のファイルがアップロードされた場合でも、このフィールドは存在します。 このプロパティの有効な値は次のとおりです。 archive - ファイルは .zip アーカイブなどのアーカイブ ファイルです。 audio - ファイルが .mp3 ファイルなどの既知の音声ファイル形式である。 document - ファイルがドキュメントまたはテキスト ファイル（MS Word ドキュメントなど）の場合。 image - ファイルが .jpeg 画像などの画像ファイルである。 other - ファイルが動画以外のファイル形式である。 project - ファイルは、実際の動画データを含まない Microsoft Windows Movie Maker プロジェクトなどの動画プロジェクト ファイルです。 video - ファイルが .mp4 ファイルなどの既知の動画ファイル形式である。
fileDetails.container	string アップロードされた動画ファイルのコンテナ形式。
fileDetails.videoStreams[]	list アップロードされた動画ファイルに含まれる動画ストリームのリスト。リスト内の各アイテムには、動画ストリームに関する詳細なメタデータが含まれています。
fileDetails.videoStreams[].widthPixels	unsigned integer エンコードされた動画コンテンツの幅（ピクセル単位）。動画のエンコード アスペクト比は width_pixels / height_pixels で計算できます。
fileDetails.videoStreams[].heightPixels	unsigned integer エンコードされた動画コンテンツの高さ（ピクセル単位）。
fileDetails.videoStreams[].frameRateFps	double 動画ストリームのフレームレート（フレーム / 秒）。
fileDetails.videoStreams[].aspectRatio	double 動画コンテンツの表示アスペクト比。動画を表示するアスペクト比を指定します。
fileDetails.videoStreams[].codec	string ストリームが使用する動画コーデック。
fileDetails.videoStreams[].bitrateBps	unsigned long 動画ストリームのビットレート（ビット/秒）。
fileDetails.videoStreams[].rotation	string 動画を正しく表示するために YouTube が元のソース コンテンツを回転させる必要がある角度。 このプロパティの有効な値は次のとおりです。 clockwise - 動画を時計回りに 90 度回転させる必要があります。 counterClockwise - 動画を反時計回りに 90 度回転させる必要があります。 none - 動画を回転する必要はありません。 other - 動画を他の方法で回転させる必要があります。 upsideDown - 動画を上下反転する必要があります。
fileDetails.videoStreams[].vendor	string 動画ベンダーを一意に識別する値。通常、この値は 4 文字のベンダー コードです。
fileDetails.audioStreams[]	list アップロードされた動画ファイルに含まれる音声ストリームのリスト。リストの各アイテムには、オーディオ ストリームに関する詳細なメタデータが含まれます。
fileDetails.audioStreams[].channelCount	unsigned integer ストリームに含まれる音声チャンネルの数。
fileDetails.audioStreams[].codec	string ストリームが使用する音声コーデック。
fileDetails.audioStreams[].bitrateBps	unsigned long オーディオ ストリームのビットレート（ビット/秒）。
fileDetails.audioStreams[].vendor	string 動画ベンダーを一意に識別する値。通常、この値は 4 文字のベンダー コードです。
fileDetails.durationMs	unsigned long アップロードされた動画の長さ（ミリ秒単位）。
fileDetails.bitrateBps	unsigned long アップロードされた動画ファイルの（動画と音声の）合計ビットレート（ビット/秒）。
fileDetails.creationTime	string アップロードされた動画ファイルの作成日時。値は ISO 8601 形式で指定します。現在、次の ISO 8601 形式がサポートされています。 日付のみ: YYYY-MM-DD Naive time: YYYY-MM-DDTHH:MM:SS タイムゾーン付きの時刻: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object processingDetails オブジェクトは、アップロードされた動画ファイルの処理における YouTube の進行状況に関する情報をカプセル化します。このオブジェクトのプロパティは、現在の処理ステータスと、YouTube が動画の処理を完了するまでの予想残り時間を表します。また、この部分は、ファイルの詳細やサムネイル画像など、さまざまなタイプのデータやコンテンツを動画で利用できるかどうかも示しています。 processingProgress オブジェクトは、アップロードされた動画が YouTube でのアップロードされた動画ファイルの処理の進捗状況を追跡できるように、ポーリングされるように設計されています。このデータを取得できるのは動画の所有者のみです。
processingDetails.processingStatus	string 動画の処理ステータス。この値は、YouTube が動画を処理できたかどうか、または動画がまだ処理中かどうかを示します。 このプロパティの有効な値は次のとおりです。 failed - 動画の処理に失敗しました。ProcessingFailureReason をさんしょうしてください。 processing - 動画は現在処理中です。ProcessingProgress を参照してください。 succeeded - 動画の処理が完了しました。 terminated - 処理情報は利用できなくなりました。
processingDetails.processingProgress	object processingProgress オブジェクトには、YouTube での動画の処理の進行状況に関する情報が含まれます。これらの値は、動画の処理ステータスが processing の場合にのみ関連します。
processingDetails.processingProgress.partsTotal	unsigned long 動画で処理する必要があるパーツの合計数の推定値。この予測値は YouTube による動画の処理が進むに従って更新され、より正確な値になる場合があります。
processingDetails.processingProgress.partsProcessed	unsigned long YouTube がすでに処理した動画のパート数。YouTube がすでに処理した動画の割合は、次の計算式で推定できます。 100 * parts_processed / parts_total 推定されるパート数は、すでに処理されたパート数の増加に対応せずに増加する可能性があるため、YouTube が動画を処理している間、計算された進行状況が定期的に減少する可能性があります。
processingDetails.processingProgress.timeLeftMs	unsigned long YouTube が動画の処理を完了するのに必要な時間の推定値（ミリ秒単位）。
processingDetails.processingFailureReason	string YouTube で動画の処理に失敗した理由。このプロパティは、processingStatus プロパティの値が failed の場合にのみ値を持ちます。 このプロパティの有効な値は次のとおりです。 other - 他の処理コンポーネントが失敗しました。 streamingFailed - 動画を配信者に送信できませんでした。 transcodeFailed - コンテンツのコード変換に失敗しました。 uploadFailed - ファイルの配信に失敗しました。
processingDetails.fileDetailsAvailability	string この値は、アップロードされた動画のファイルの詳細情報が利用可能かどうかを示します。videos.list() リクエストで fileDetails 部分をリクエストすると、動画のファイルの詳細を取得できます。
processingDetails.processingIssuesAvailability	string この値は、動画処理エンジンが、YouTube の動画処理能力を向上させる可能性のある提案、動画処理の問題を説明する警告、動画処理の問題を引き起こすエラーを生成したかどうかを示します。これらの提案を取得するには、videos.list() リクエストで suggestions 部分をリクエストします。
processingDetails.tagSuggestionsAvailability	string この値は、動画でキーワード（タグ）の候補が利用可能かどうかを示します。タグを動画のメタデータに追加すると、他のユーザーがその動画を検索しやすくなります。これらの候補を取得するには、videos.list() リクエストで suggestions 部分をリクエストします。
processingDetails.editorSuggestionsAvailability	string この値は、動画の画質や再生エクスペリエンスを向上させる可能性のある動画編集の提案が動画で利用可能かどうかを示します。これらの提案を取得するには、videos.list() リクエストで suggestions 部分をリクエストします。
processingDetails.thumbnailsAvailability	string この値は、動画のサムネイル画像が生成されたかどうかを示します。
suggestions	object suggestions オブジェクトは、アップロードされた動画の画質やメタデータを改善する機会を特定する提案をカプセル化します。このデータは、動画の所有者のみが取得できます。 suggestions オブジェクトは、processingDetails.tagSuggestionsAvailability プロパティまたは processingDetails.editorSuggestionsAvailability プロパティの値が available の場合にのみ返されます。
suggestions.processingErrors[]	list アップロードされた動画の処理を YouTube が正常に行うことができない原因となるエラーのリスト。これらのエラーは、動画の現在の処理ステータスに関係なく、最終的にそのステータスが failed になる可能性が非常に高いことを示します。 このプロパティの有効な値は次のとおりです。 archiveFile - アーカイブ ファイル（ZIP アーカイブなど）。 audioFile - ファイルに音声のみが含まれている（MP3 ファイルなど）。 docFile - ドキュメントまたはテキスト ファイル（MS Word ドキュメントなど）。 imageFile - 画像ファイル（JPEG 画像など）。 notAVideoFile - 動画以外のファイル。 projectFile - ムービー プロジェクト ファイル（Microsoft Windows ムービー メーカーのプロジェクトなど）。
suggestions.processingWarnings[]	list アップロードされた動画のトランスコードが YouTube で困難になる理由、またはトランスコードが誤って行われる可能性がある理由のリスト。このような警告は、YouTube が実際にアップロード済み動画ファイルを処理する前に生成されます。また、動画処理が失敗するとは限らないものの、同期の問題、動画のアーティファクト、音声トラックの欠落などの問題を引き起こす可能性がある問題も特定します。 このプロパティの有効な値は次のとおりです。 hasEditlist - 現在、リストの編集はサポートされていません。 inconsistentResolution - コンテナとストリームの解像度が競合しています。 problematicAudioCodec - 問題を引き起こすことがわかっている音声コーデックが使用されました。 problematicVideoCodec - 問題を引き起こすことがわかっている動画コーデックが使用されました。 unknownAudioCodec - 認識できない音声コーデック。トランスコードが失敗する可能性があります。 unknownContainer - 認識できないファイル形式。コード変換が失敗する可能性があります。 unknownVideoCodec - 認識できない動画コーデック。コード変換が失敗する可能性があります。
suggestions.processingHints[]	list YouTube の動画処理能力を向上させる可能性のある提案のリスト。 このプロパティの有効な値は次のとおりです。 nonStreamableMov - MP4 ファイルをストリーミングできません。処理に時間がかかります。 sendBestQualityVideo - 動画のより高品質なバージョンが存在する可能性があります。
suggestions.tagSuggestions[]	list YouTube で検索またはブラウジングしたときにユーザーが動画を見つけやすくなるように、動画のメタデータに追加できるキーワード タグのリスト。
suggestions.tagSuggestions[].tag	string 動画に推奨されるキーワード タグ。
suggestions.tagSuggestions[].categoryRestricts[]	list タグが関連する動画カテゴリのセット。この情報を使用すると、動画をアップロードしたユーザーが動画に関連付けた動画カテゴリに基づいて、適切なタグの提案を表示することができます。キーワードに対する制限が設定されていない場合、デフォルトではタグの提案にはすべてのカテゴリが該当します。
suggestions.editorSuggestions[]	list アップロードされた動画の画質や再生エクスペリエンスを向上させる可能性のある動画編集オペレーションのリスト。 このプロパティの有効な値は次のとおりです。 audioQuietAudioSwap - 音声トラックが聞こえないため、音質の高いトラックに置き換えることができます。 videoAutoLevels - 写真の明るさのレベルが適切でないため、修正が必要である。 videoCrop - 写真の周囲で検出された余白（マット）が切り取られる可能性があります。 videoStabilize - 動画が揺れており、手ぶれ補正を適用できる可能性があります。
liveStreamingDetails	object liveStreamingDetails オブジェクトには、ライブ動画配信に関するメタデータが含まれます。このオブジェクトは、動画が予定されているライブ配信、ライブ配信中、または完了したライブ配信である場合にのみ、video リソースに存在します。
liveStreamingDetails.actualStartTime	datetime ブロードキャストが実際に開始された時刻。値は ISO 8601 形式で指定します。この値は、ブロードキャストが開始されるまで使用できません。
liveStreamingDetails.actualEndTime	datetime ブロードキャストが実際に終了した時刻。値は ISO 8601 形式で指定します。この値は、ブロードキャストが終了するまで使用できません。
liveStreamingDetails.scheduledStartTime	datetime ブロードキャストの開始予定時刻。値は ISO 8601 形式で指定します。
liveStreamingDetails.scheduledEndTime	datetime ブロードキャストの終了予定時刻。値は ISO 8601 形式で指定します。値が空の場合や、このプロパティが存在しない場合は、ブロードキャストは無期限に継続される予定です。
liveStreamingDetails.concurrentViewers	unsigned long 現在放送を視聴している視聴者の数。放送に視聴者がいて、放送の所有者が動画の視聴回数を非表示にしていない場合、このプロパティとその値が存在します。YouTube では、放送が終了すると、放送の同時視聴者数の追跡が停止します。そのため、このプロパティでは、すでに終了したライブ放送のアーカイブ動画を視聴している視聴者の数を特定できません。 YouTube Data API が返す同時視聴者数は、YouTube アナリティクスで確認できるスパム処理済みの同時視聴者数と異なる場合があります。ライブ配信の指標について詳しくは、YouTube ヘルプセンターをご覧ください。
liveStreamingDetails.activeLiveChatId	string この動画に現在関連付けられているアクティブなライブチャットの ID。このフィールドは、動画がライブチャット付きのライブ配信である場合にのみ入力されます。ブロードキャストが完了に移行すると、このフィールドは削除され、ライブチャットは終了します。永続的なブロードキャストの場合、ライブチャット ID はこの動画ではなく、永続的なページに表示される新しい動画に関連付けられます。
localizations	object localizations オブジェクトには、動画のメタデータの翻訳が含まれます。
localizations.(key)	object キー値に関連付けられたローカライズされたテキストの言語。値は BCP-47 言語コードを含む文字列です。
localizations.(key).title	string ローカライズされた動画のタイトル。
localizations.(key).description	string ローカライズされた動画の説明。