Videos

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

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

メソッド

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

getRating

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

list

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

insert

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

update

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

delete

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

税率

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

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 または 2D で視聴可能かどうかを示します。
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 - 18 歳以上 acbUnrated
contentDetails.contentRating.agcomRating	string イタリアの Autorità per le Garanzie nelle Comunicazioni（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）の動画のレーティング。詳しくは、Canadian Broadcast Standards Council のウェブサイトをご覧ください。 このプロパティの有効な値は次のとおりです。 catv14plus - 14 歳以上 catv18plus - 18 歳以上 catvC - C catvC8～ C8 catvG～ G catvPg - PG catvUnrated
contentDetails.contentRating.catvfrRating	string カナダのフランス語放送向けのカナダ放送通信委員会（CRTC）による動画の評価。詳しくは、Canadian Broadcast Standards Council のウェブサイトをご覧ください。 このプロパティの有効な値は次のとおりです。 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 bypasso ccc6～ 6 歳以上 - 7 日前 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 動画の Canadian Home Video Rating System（CHVRS）レーティング。 このプロパティの有効な値は次のとおりです。 chvrs14a - 14A chvrs18a - 18A chvrsE - E chvrsG - G chvrsPg - PG chvrsR - R chvrsUnrated
contentDetails.contentRating.cicfRating	string ベルギーの映画検閲委員会による動画の評価。 このプロパティの有効な値は次のとおりです。 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 分類シネマトグラフ このプロパティの有効な値は次のとおりです。 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 - 小学校から高等学校 eefilmK14 - K-14 eefilmK16～ K-16 eefilmK6 - 小学校 1～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 動画の映倫（映倫）によるレーティング。Eirin は日本の評価システムです。 このプロパティの有効な値は次のとおりです。 eirinG - G eirinPg12 - PG-12 eirinR15plus - R15+ eirinR18plus - 18 歳以上 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 南アフリカの Film and Publication Board による動画の評価。 このプロパティの有効な値は次のとおりです。 fpb10 - 10 fpb1012Pg - 10-12PG fpb13 - 13 fpb16～ 16 fpb18 - 18 fpb79Pg - 7～9 歳 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～小中高 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 動画のアイリッシュ フィルム クラシフィケーション オフィス（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（Instituto Nacional de Cine y Artes Audiovisuales - Argentina）レーティング。 このプロパティの有効な値は次のとおりです。 incaaAtp – ATP（Apta para todo publico） incaaC – X（Solo apta para mayores de 18 años, de exhibición condicionada） incaaSam13～ 13 日（Solo apta para mayores de 13 años） incaaSam16～ 16（Solo apta para Mayores de 16 años） incaaSam18 – 18 (Solo apta para mayores de 18 años) 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 - アルバニア 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 - ボリビア lsfD～ D lsfR - R lsfSu～日 lsfUnrated
contentDetails.contentRating.mccaaRating	string Maltese Film Age-Classification Board による動画のレーティング。 このプロパティの有効な値は次のとおりです。 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 シンガポールのメディア開発局（MDA）および、特に映画検閲局（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（National Audiovisual Institute）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 meku12 - 12 meku16～ 16 meku18～ 18 meku7 - 7 mekuS - S mekuUnrated
contentDetails.contentRating.mibacRating	string Ministero dei Beni e delle Attività Culturali e del Turismo（イタリア）による動画の評価。 このプロパティの有効な値は次のとおりです。 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 Maldives National Bureau of Classification による動画のレーティング。 このプロパティの有効な値は次のとおりです。 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～ 12 A nfvcb15 - 15 nfvcb18 - 18 nfvcbG - G nfvcbPg - PG nfvcbRe - RE nfvcbUnrated
contentDetails.contentRating.nkclvRating	string Nacionãlais Kino centrs（ラトビアの国立映画センター）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 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 動画の General Directorate of Radio, Television and Cinematography（メキシコ）のレーティング。 このプロパティの有効な値は次のとおりです。 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 に設定する必要があります。 過去の時点で動画の公開をスケジュール設定した場合、動画はすぐに公開されます。そのため、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 動画が再生された回数。
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 身体的魅力 [美容] /m/07c1v テクノロジー /m/07bxq 観光 /m/07yv9 乗り物 社会トピック /m/098wr 社会（親トピック） /m/09s1f ビジネス /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 ナイーブ時間: YYYY-MM-DDTHH:MM:SS タイムゾーンを含む時刻: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails	object processingDetails オブジェクトは、アップロードされた動画ファイルの処理の進行状況に関する情報をカプセル化します。このオブジェクトのプロパティは、現在の処理ステータスと、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 動画の処理が完了するまでにかかる時間（ミリ秒単位）の推定値。
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 が実際にアップロード済み動画ファイルを処理する前に生成されます。また、動画処理の失敗を必ずしも示していないものの、同期の問題、動画のアーティファクト、音声トラックの欠落などの問題を引き起こす可能性がある問題も特定できます。 このプロパティの有効な値は次のとおりです。 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 ローカライズされた動画の説明。