Videos

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

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

メソッド

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

getRating
指定された動画のリストに対して承認済みユーザーが付けた評価を取得します。今すぐ試す
list
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 または 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）の動画のレーティング。詳しくは、カナダ放送基準評議会のウェブサイトをご覧ください。

このプロパティの有効な値は次のとおりです。
  • 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
動画の 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 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 - アルバニア
  • 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 - ボルネオ
  • 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
南アフリカの映画出版委員会による動画のレーティング。

このプロパティの有効な値は次のとおりです。
  • 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 - 小学校から高等学校
  • 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 - 英国（緑色の帯 - すべての視聴者に承認）
  • 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 - 12A
  • 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

動画が再生された回数。

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 の小さなセットを返すようになりました。
topicDetails.topicCategories[] list
動画の内容の概要を説明するウィキペディアの 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
動画の処理を完了するために 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 が実際にアップロード済み動画ファイルを処理する前に生成されます。また、動画処理が失敗するわけではないが、同期の問題、動画アーティファクト、音声トラックの欠落などの問題を引き起こす可能性がある問題も特定します。

このプロパティの有効な値は次のとおりです。
  • 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
ローカライズされた動画の説明。