Videos

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

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

Methods

この API では、videos リソースについて次のメソッドがサポートされています。

getRating
承認されたユーザーが指定した動画のリストに付けた評価を取得します。今すぐ試す
list
API リクエストのパラメータに一致する動画のリストを返します。今すぐ試す
挿入
YouTube に動画をアップロードします。必要に応じて動画のメタデータを設定します。
update
動画のメタデータを更新します。 今すぐ試す
delete
YouTube 動画を削除します。 今すぐ試す
利率
動画に高評価または低評価を付けたり、動画から評価を削除したりできます。今すぐ試す
不正行為の報告
不適切なコンテンツを含む動画を報告します。今すぐ試す

リソース表現

次の 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
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "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
有効な Key-Value は次のとおりです。
  • default – デフォルトのサムネイル画像。動画(または、再生リストのアイテムや検索結果など、動画を参照するリソース)のデフォルト サムネイルは幅 120px、高さ 90px です。チャンネルのデフォルト サムネイルは幅 88px、高さ 88px です。
  • medium – サムネイル画像の高解像度バージョン。動画(または動画を参照するリソース)の場合、この画像は幅 320px、高さ 180px です。チャンネルの場合は、幅 240px、高さ 240px です。
  • high – サムネイル画像の高解像度バージョン。動画(または動画を参照するリソース)の場合、この画像は幅 480px、高さ 360px です。チャンネルの場合、幅 800px、高さ 800px です。
  • standardhigh 解像度の画像よりも高い解像度のサムネイル画像。この画像は、一部の動画や、動画を参照するその他のリソース(再生リストのアイテムや検索結果など)で使用できます。この画像は幅 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 という文字は値が期間を指定することを示し、MS は、それぞれ分と秒の長さを表します。M 文字と S 文字に先行する # 文字はどちらも、動画の分数(秒)を指定する整数です。たとえば、値 PT15M33S は動画の長さが 15 分 33 秒であることを示します。

動画の長さが 1 時間以上の場合、再生時間は PT#H#M#S の形式になります。H の文字の前の # は動画の長さを時間単位で指定します。その他の詳細情報は上記と同じです。動画の長さが 1 日以上の場合は、文字 PT が区切られ、値の形式は 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~月
  • acbMa15plus~ MA15+
  • acbP – オーストラリア通信メディア庁によって P 分類を受けた番組です。これらのプログラムは就学前のお子様を対象としています。
  • acbPg~ PG
  • acbR18plus~ R18 以上
  • acbUnrated
contentDetails.contentRating.agcomRating string
イタリアの Autorità による 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~金
  • 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~ 12 A
  • 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
Canadian TV のレーティング システム - Canadian TV Classification System カナダの英語放送を対象としたカナダのラジオテレビおよび電気通信委員会(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
動画の Central Board of Film Certification(CBFC - India)によるレーティング。

このプロパティで有効な値は次のとおりです。
  • 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 ターゲットとする
  • 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~ 14 A
  • chvrs18a~ 18 A
  • 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
フランスのレーティング システム - 委員会による分類器官庁

このプロパティで有効な値は次のとおりです。
  • 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 laClassification 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~ 13 A
  • ecbmct13plus~ 13 歳以上
  • ecbmct15a~ 15 A
  • ecbmct15plus~ 15 歳以上
  • ecbmct18plus~ 18 歳以上
  • ecbmct7a~ 7 A
  • ecbmct7plus~ 7 歳以上
  • ecbmctG~ G
  • ecbmctUnrated
  • ecbmct6a~ 6A
  • ecbmct6plus~ 6 歳以上
  • ecbmct10a~ 10 A
  • 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 - ペレ
  • 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~ 18 PA
  • 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 プロパティを使用してください。

動画の 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 ~ 9PG
  • fpbA~ A
  • fpbPg~ PG
  • fpbUnrated
  • fpbX18~ X18
  • fpbXx~ XX
contentDetails.contentRating.fpbRatingReasons[] list
動画が FPB(南アフリカ)レーティングを獲得した理由を説明する理由。
contentDetails.contentRating.fskRating string
動画の Freiwillige Selbstkontrolle der Filmwirtschaft(FSK - ドイツ)によるレーティング。

このプロパティで有効な値は次のとおりです。
  • fsk0~ FSK 0
  • fsk12~ FSK 12
  • fsk16~ FSK 16
  • fsk18~ FSK 18
  • fsk6~ FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
ギリシャでの動画のレーティング。

このプロパティで有効な値は次のとおりです。
  • grfilmE~ E
  • grfilmK~ K
  • grfilmK12~ K-12
  • grfilmK13~ K-13
  • grfilmK15~ K-15
  • grfilmK17~ K-17
  • grfilmK18~ K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
動画の Instituto de la Cinematografía y de las Artes Audiovisuales(ICAA - スペイン)の評価。

このプロパティで有効な値は次のとおりです。
  • icaa12~ 12
  • icaa13~ 13
  • icaa16~ 16
  • icaa18~ 18
  • icaa7~ 7
  • icaaApta - APTA
  • icaaUnrated
  • icaaX~ X
contentDetails.contentRating.ifcoRating string
Irish Film Classification Office(IFCO - アイルランド)による動画のレーティング。詳細については、IFCO のウェブサイトをご覧ください。

このプロパティで有効な値は次のとおりです。
  • ifco12~ 12
  • ifco12a~ 12 A
  • ifco15~ 15
  • ifco15a~ 15 A
  • 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 - アルゼンチン)のレーティング。

このプロパティで有効な値は次のとおりです。
  • 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~ AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
韓国メディア等級委員会(権限が付与される)による動画のレーティング。KMRB は韓国で動画を評価します。

このプロパティで有効な値は次のとおりです。
  • kmrb12plus~ 12 歳以上観客
  • kmrb15plus~ 15 歳以上観客
  • kmrbAll – ה체
  • kmrbR – 청년 不可参加者
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
インドネシアの Lembaga センサー フィルムによる動画のレーティング。

このプロパティで有効な値は次のとおりです。
  • lsf13~ 13
  • lsf17~ 17
  • lsf21~ 21
  • lsfA~ A
  • lsfBo~ BO
  • lsfD~ D
  • lsfR~ R
  • lsfSu~日
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
マルタの映画年齢分類委員会による動画のレーティング。

このプロパティで有効な値は次のとおりです。
  • mccaa12~ 12
  • mccaa12a~ 12 A
  • mccaa14~ 14 - このレーティングは、2013 年に導入された新しい分類構造から削除されました。
  • mccaa15~ 15
  • mccaa16~ 16 - このレーティングは、2013 年に導入された新しい分類構造から削除されました。
  • mccaa18~ 18
  • mccaaPg~ PG
  • mccaaU~ U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Danish Film Institute(Det Danske Filminstitut)Media Council for Children and Young People による動画のレーティング。

このプロパティで有効な値は次のとおりです。
  • 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)、具体的には 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 Audiovisualinen 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
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
ナイジェリアの国立映画監督庁による動画のレーティング。

このプロパティで有効な値は次のとおりです。
  • 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~月
  • 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~太平洋時間
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
ベネズエラでの動画のレーティング。

このプロパティで有効な値は次のとおりです。
  • resorteviolenciaA~ A
  • resorteviolenciaB~ B
  • resorteviolenciaC~ C
  • resorteviolenciaD~ D
  • resorteviolenciaE~ E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
動画のラジオ・テレビ・映画撮影総局(メキシコ)のレーティング。

このプロパティで有効な値は次のとおりです。
  • rtcA~ A
  • rtcAa~ AA
  • rtcB~ B
  • rtcB15~ B15
  • rtcC~ C
  • rtcD~ D
  • rtcUnrated
contentDetails.contentRating.rteRating string
アイルランドの Raidió Teilifís Éireann による動画のレーティング。

このプロパティで有効な値は次のとおりです。
  • rteCh~ CH
  • rteGa - 一般提供
  • rteMa~ MA
  • rtePs~ PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
動画の全米映画登録機関(MKRF - ロシア)のレーティング。

このプロパティで有効な値は次のとおりです。
  • russia0~ 0 以上
  • russia12~ 12 歳以上
  • russia16~ 16 歳以上
  • russia18~ 18 歳以上
  • russia6~ 6 歳以上
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
スロバキアでの動画のレーティング。

このプロパティで有効な値は次のとおりです。
  • skfilmG~ G
  • skfilmP2~ P2
  • skfilmP5~ P5
  • skfilmP8~ P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
アイスランドでの動画のレーティング。

このプロパティで有効な値は次のとおりです。
  • smais12~ 12
  • smais14~ 14
  • smais16~ 16
  • smais18~ 18
  • smais7~ 7
  • smaisL~ L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Statens medieråd(スウェーデンの National Media Council)による動画の評価。

このプロパティで有効な値は次のとおりです。
  • smsa11~ 11
  • smsa15~ 15
  • smsa7~ 7
  • smsaA – すべての年齢層
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
動画の TV 保護者による使用制限(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 プロパティに過去の日時を設定した場合は、動画の privacyStatusprivate から 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 リクエストを承認した場合にのみプロパティ値が返されます。
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
動画のコメント数。
player object
player オブジェクトには、埋め込みプレーヤーで動画を再生する際に使用する情報が格納されます。
player.embedHtml string
動画を再生するプレーヤーを埋め込む <iframe> タグ。
  • リソースを取得する API リクエストで maxHeight パラメータや maxWidth パラメータの値が指定されている場合、埋め込みプレーヤーのサイズは maxHeightmaxWidth の要件を満たすように調整されます。
  • 動画のアスペクト比が不明な場合、埋め込みプレーヤーではデフォルトの 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 8601YYYY-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
動画を適切に表示するために、元のソース コンテンツを回転させるために必要な量です。

このプロパティで有効な値は次のとおりです。
  • 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 の進捗状況情報をカプセル化します。このオブジェクトのプロパティは、現在の処理ステータスと、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 Movie Maker プロジェクト)。
suggestions.processingWarnings[] list
YouTube でアップロードされた動画のコード変換が難しい理由、またはコード変換の不具合が生じる可能性のある理由の一覧。このような警告は、YouTube が実際にアップロード済み動画ファイルを処理する前に生成されます。また、動画処理の失敗を示しているとは限らないものの、同期の問題、動画のアーティファクト、音声トラックの欠落などの問題の原因となる可能性がある問題も特定します。

このプロパティの有効な値は次のとおりです。
  • hasEditlist – リストの編集は現在サポートされていません。
  • inconsistentResolution – コンテナとストリームの解像度が競合しています。
  • problematicAudioCodec – 問題の原因になることがわかっているオーディオ コーデックが使用されました。
  • problematicVideoCodec – 問題の原因になることがわかっている動画コーデックが使用されました。
  • unknownAudioCodec – 認識できないオーディオ コーデック。コード変換が失敗する可能性があります。
  • unknownContainer – 認識できないファイル形式。コード変換が失敗する可能性があります。
  • unknownVideoCodec – 認識できない動画コーデックです。コード変換が失敗する可能性があります。
suggestions.processingHints[] list
YouTube での動画の処理能力を向上させる可能性のある提案のリスト。

このプロパティで有効な値は次のとおりです。
  • nonStreamableMov – MP4 ファイルはストリーミングできないため、処理が遅くなります。
  • sendBestQualityVideo – より高画質の動画が存在する可能性があります。
suggestions.tagSuggestions[] list
ユーザーが YouTube で検索またはブラウジングする際に動画を見つけやすくするために、動画のメタデータに追加できるキーワードタグのリスト。
suggestions.tagSuggestions[].tag string
動画に対して提案されたキーワードタグ。
suggestions.tagSuggestions[].categoryRestricts[] list
タグが関連する動画カテゴリのセット。この情報を使用すると、動画をアップロードしたユーザーが動画に関連付けた動画カテゴリに基づいて、適切なタグの提案を表示することができます。キーワードに対する制限が設定されていない場合、デフォルトではタグの提案にはすべてのカテゴリが該当します。
suggestions.editorSuggestions[] list
アップロードした動画の品質や再生エクスペリエンスを改善する可能性のある動画編集操作のリスト。

このプロパティで有効な値は次のとおりです。
  • audioQuietAudioSwap – 音声トラックは無音で、より高品質なものに切り替えられます。
  • videoAutoLevels – 画像の明るさがオフになっています。補正できます。
  • videoCrop – 画像の周囲で検出された余白(マット)をトリミングできます。
  • videoStabilize – 動画にブレがあり、手ぶれ補正が可能です。
liveStreamingDetails object
liveStreamingDetails オブジェクトには、ライブ動画のブロードキャストに関するメタデータが含まれます。オブジェクトが今後、ライブ配信中、または終了したライブ配信の場合にのみ、video リソースに含まれます。
liveStreamingDetails.actualStartTime datetime
配信が実際に開始された時刻。値は ISO 8601 形式で指定します。この値は、ブロードキャストが開始されるまで使用できません。
liveStreamingDetails.actualEndTime datetime
配信が実際に終了した時刻。値は ISO 8601 形式で指定します。この値は、ブロードキャストが終了するまで使用できません。
liveStreamingDetails.scheduledStartTime datetime
配信の開始時間。値は ISO 8601 形式で指定します。
liveStreamingDetails.scheduledEndTime datetime
ブロードキャストの終了が予定されている時刻。値は ISO 8601 形式で指定します。値が空の場合、またはプロパティが存在しない場合、ブロードキャストは無期限に継続するようにスケジュールされます。
liveStreamingDetails.concurrentViewers unsigned long
現在配信を視聴している視聴者の数。ブロードキャストに現在閲覧者がいて、ブロードキャストの所有者が動画の再生回数を非表示にしていない場合、このプロパティとその値が存在します。配信が終了すると、YouTube は配信の同時視聴者数のトラッキングを停止します。そのため、このプロパティでは、ライブ配信がすでに終了し、アーカイブされた動画を視聴している視聴者の数は識別されません。
YouTube Data API が返す同時視聴者数は、YouTube アナリティクスで確認可能な、処理済みでスパム除去された同時視聴者数とは異なる場合があります。ライブ配信の指標について詳しくは、YouTube ヘルプセンターをご覧ください。
liveStreamingDetails.activeLiveChatId string
この動画に関連付けられている現在アクティブなチャットの ID。このフィールドは、動画が現在チャットを含むライブ配信の場合にのみ入力されます。配信が終了してこのフィールドが入力されると、チャットは終了します。常時配信の場合、チャット ID はこの動画ではなく、固定ページに表示される新しい動画と関連付けられます。
localizations object
localizations オブジェクトには、動画のメタデータの翻訳が格納されます。
localizations.(key) object
キー値に関連付けられているローカライズされたテキストの言語。値は、BCP-47 言語コードを含む文字列です。
localizations.(key).title string
ローカライズされた動画のタイトル。
localizations.(key).description string
ローカライズされた動画の説明。