Videos

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
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": 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 文字を使用できます。 注: 説明内の URL を YouTube UI でクリック可能なリンクとして表示するには、チャンネルがプラットフォーム レベルの要件（チャンネルの確認や上級者向け機能の有効化など）を満たしている必要があります。 動画チャプターを作成するには、説明テキストに書式設定されたタイムスタンプ（例: 00:00）を含めます。
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 ピクセルです。 fhd - サムネイル画像のフル HD（1080p）バージョン。この画像サイズは一部の動画で利用できます。この画像のサイズは幅 1,920 ピクセル、高さ 1,080 ピクセルです。 qhd - サムネイル画像のクアッド HD（1440p / 2K）バージョン。この画像サイズは一部の動画で利用できます。この画像のサイズは幅 2,560 ピクセル、高さ 1,440 ピクセルです。 uhd - サムネイル画像の超高解像度（4K）バージョン。この画像サイズは一部の動画で利用できます。この画像のサイズは幅 3,840 ピクセル、高さ 2,160 ピクセルです。
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 仕様をご覧ください。 注: コード変換とエンコードの違いにより、返される再生時間は実際の再生時間と若干異なる場合があります（たとえば、1 秒の差）。
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 - 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 動画の全英映像等級審査機構（BBFC）のレーティング。 このプロパティの有効な値は次のとおりです。 bbfc12 - 12 bbfc12a – 12A bbfc15 – 15 bbfc18 – 18 bbfcPg - PG bbfcR18 - R18 bbfcU - U bbfcUnrated
contentDetails.contentRating.bfvcRating	string タイの Board of Film and Video Censors による動画の評価。 このプロパティの有効な値は次のとおりです。 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 歳以上 - ポルノ コンテンツ ccc18v – 18+ - contenido excesivamente violento 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 動画のカナダ ホームビデオ レーティング システム（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 香港の Office for Film, Newspaper and Article Administration による動画のレーティング。 このプロパティの有効な値は次のとおりです。 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 ～ 12 ページ 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 - 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 動画のアイルランド映画分類局（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（13 歳以上対象） incaaSam16 - 16（16 歳以上のみ） incaaSam18 - 18（18 歳以上のみ） incaaUnrated
contentDetails.contentRating.kfcbRating	string ケニア映画分類委員会（Kenya Film Classification Board）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 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 動画の韓国映像物等級委員会（Korea Media Rating Board、영상물등급위원회）によるレーティング。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 マルタの 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 シンガポールの 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 映画の予告編とプレビューに対するアメリカ映画協会（MPAA）のレーティング。 このプロパティの有効な値は次のとおりです。 mpaatGb - GB（グリーン バンド - すべてのユーザーに承認済み） mpaatRb - RB（レッドバンド - 17 歳以上推奨）
contentDetails.contentRating.mtrcbRating	string Movie and Television Review and Classification Board（フィリピン）による動画のレーティング。 このプロパティの有効な値は次のとおりです。 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 動画の Office of Film and Literature Classification（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 - スイス rteGa - GA 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 動画のプライバシー ステータス。videos.insert リクエストでこのプロパティの値を指定しない場合、アップロードされた動画のプライバシー ステータスはデフォルトで public になります。YouTube ヘルプセンターで説明されているように、クリエイターのアカウント設定に基づいて、特定のアップロードがデフォルトで private になる場合があります。未確認の API プロジェクトからアップロードされた動画は、非公開の視聴モードに制限されません。 このプロパティの有効な値は次のとおりです。 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 この値は、動画を別のウェブサイトに埋め込めるかどうかを示します。 注: アップロードしたユーザーの設定で埋め込みが許可されている場合でも、プラットフォームのポリシーや第三者からの申し立て（Content ID など）により、埋め込みプレーヤーでの動画の再生がブロックされることがあります。
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 動画が再生された回数。 2026 年 8 月 24 日より、チャンネルのすべての動画フォーマット（長尺動画、ライブ、ショート）において、動画の再生が開始された瞬間（自動再生、ポインタを合わせる、クリックまたはタップして再生を含む）に視聴回数がカウントされるよう、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 ビジネス /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 オブジェクトは、アップロードされた動画の動画の画質またはメタデータを改善する機会を特定する提案をカプセル化します。このデータを取得できるのは動画の所有者のみです。 processingDetails.tagSuggestionsAvailability プロパティまたは processingDetails.editorSuggestionsAvailability プロパティの値が available の場合にのみ、suggestions オブジェクトが返されます。
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 はこの動画に関連付けられなくなり、永続的なページに表示される新しい動画に関連付けられます。
brandPartner	object brandPartner オブジェクトには、クリエイター主導のブランド パートナー アクセス（CI BPA）で動画にリンクされているブランド パートナーに関する詳細が含まれます。
brandPartner.channelId	string ブランド パートナーの外部チャンネル ID。このフィールドは「UC」で始まる必要があります。アクセスを確立する際に channelId または channelHandle のいずれかを設定する必要がありますが、レスポンスで返されるのは channelId のみです。
brandPartner.channelHandle	string ブランド パートナーのチャンネル ハンドル。このフィールドは「@」で始まる必要があります。アクセス権を確立するときに channelId または channelHandle のいずれかを設定する必要がありますが、レスポンスで返されるのは channelId のみです。
localizations	object localizations オブジェクトには、動画のメタデータの翻訳が含まれます。
localizations.(key)	object キー値に関連付けられたローカライズされたテキストの言語。値は BCP-47 言語コードを含む文字列です。
localizations.(key).title	string ローカライズされた動画のタイトル。
localizations.(key).description	string ローカライズされた動画の説明。