Videos

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

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

Methods

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

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

リソース表現

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

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "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
有効なキー値は次のとおりです。
  • 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 は長さ(分と秒)をそれぞれ示します。文字 MS の前にある # 文字はどちらも、動画の分(または秒)を指定する整数です。たとえば、値 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
Australian Classification Board(ACB)または Australian Communications and Media Authority(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~州間高速道路 10 号線
  • anatelI12~州間高速道路 12 号線
  • anatelI7~州間高速道路 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
タイの映像検閲委員会による動画の評価。

このプロパティの有効な値は次のとおりです。
  • bfvc13~ 13
  • bfvc15~ 15
  • bfvc18~ 18
  • bfvc20~ 20
  • bfvcB~ B
  • bfvcE~ E
  • bfvcG~ G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
オーストリアのメディア分類委員会(Bundesministerium für Unterricht、Kunst und Kultur)による動画の評価。

このプロパティの有効な値は次のとおりです。
  • bmukk10~ 10 以上
  • bmukk12~ 12 歳以上
  • bmukk14~ 14 歳以上
  • bmukk16~ 16 歳以上
  • bmukk6~ 6 歳以上
  • bmukk8~ 8 歳以上
  • bmukkAa – 制限なし
  • bmukkUnrated
contentDetails.contentRating.catvRating string
カナダのテレビのレーティング システム - カナダのテレビ分類システム カナダの英語放送に関するカナダ無線テレビおよび電気通信委員会(CRTC)による動画のレーティングです。詳しくは、Canadian Broadcast Standards Council のウェブサイトをご覧ください。

このプロパティの有効な値は次のとおりです。
  • catv14plus~ 14 歳以上
  • catv18plus~ 18 歳以上
  • catvC~ C
  • catvC8~ C8
  • catvG~ G
  • catvPg~ PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
カナダのフランス語放送に対するカナダの無線テレビ電気通信委員会(CRTC)による動画のレーティング。詳しくは、Canadian Broadcast Standards Council のウェブサイトをご覧ください。

このプロパティの有効な値は次のとおりです。
  • catvfr13plus~ 13 歳以上
  • catvfr16plus~ 16 歳以上
  • catvfr18plus~ 18 歳以上
  • catvfr8plus~ 8 歳以上
  • catvfrG~ G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
動画の 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 excesivamentebido
  • ccc6~ 6 歳以上 - Inconveniente para menores de 7 años
  • cccTe – Todo espectador(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 companytographique

このプロパティで有効な値は次のとおりです。
  • 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 desfis(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~ 15 A
  • ecbmct15plus~ 15 歳以上
  • ecbmct18plus~ 18 歳以上
  • ecbmct7a~ 7A
  • 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~ 6 年生
  • eefilmL~ L
  • eefilmMs12 - MS-12
  • eefilmMs6 - MS-6
  • eefilmPere – ペレ
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
エジプトでの動画の評価。

このプロパティの有効な値は次のとおりです。
  • egfilm18~ 18
  • egfilmBn~ニュース速報
  • egfilmGn~ GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
映倫による動画のレーティング。エイリンは日本のレーティング システムです。

このプロパティの有効な値は次のとおりです。
  • 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~ 18 SG
  • fcbm18sx~ 18SX
  • fcbmP12~ P12
  • fcbmP13~ P13
  • fcbmPg13~ PG13
  • fcbmU~ U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
香港映画新聞・記事管理局による動画のレーティング。

このプロパティの有効な値は次のとおりです。
  • fcoI~ I
  • fcoIi~ II
  • fcoIia – IIA
  • fcoIib~ IIB
  • fcoIii~ III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
このプロパティは 2015 年 11 月 2 日に非推奨となりました。代わりに contentDetails.contentRating.cncRating プロパティを使用してください。

動画の「Centre National du cinéma et de l'image animé」(仏文化省)の評価。

このプロパティの有効な値は次のとおりです。
  • fmoc10~ 10
  • fmoc12~ 12
  • fmoc16~ 16
  • fmoc18~ 18
  • fmocE~ E
  • fmocU~ U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
南アフリカの Film and Publication Board による動画のレーティング。

このプロパティの有効な値は次のとおりです。
  • fpb10~ 10
  • fpb1012Pg~ 10 ~ 12PG
  • fpb13~ 13
  • fpb16~ 16
  • fpb18~ 18
  • fpb79Pg~ 7 ~ 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 - Ireland)による動画のレーティング。詳細については、IFCO のウェブサイトをご覧ください。

このプロパティの有効な値は次のとおりです。
  • ifco12~ 12
  • ifco12a~ 12A
  • 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 paramayores 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
韓国メディア レイティング委員会(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~日
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
マルタの映画年齢分類委員会による動画のレーティング。

このプロパティの有効な値は次のとおりです。
  • mccaa12~ 12
  • mccaa12a~ 12A
  • mccaa14 – 14 - この評価は、2013 年に導入された新しい分類構造から削除されました。
  • mccaa15~ 15
  • mccaa16 – 16 - この評価は、2013 年に導入された新しい分類構造から削除されました。
  • mccaa18~ 18
  • mccaaPg~ PG
  • mccaaU~ U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
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 Audiovisuaalinen Instituutti(国立視聴覚研究所)による動画の評価です。

このプロパティの有効な値は次のとおりです。
  • 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
動画の文化省(コロンビア)による評価。

このプロパティの有効な値は次のとおりです。
  • 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 歳以上
  • nbcG~ G
  • nbcPg~ PG
  • nbcPu~ PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Bulgarian National Film Center による動画の評価。

このプロパティの有効な値は次のとおりです。
  • 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 – 太平洋時間
  • 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
National Film Registry of the Russian Federation(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 ペアレンタル ガイドライン(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 日をもって非推奨となりました。この API は 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 ムービー メーカー プロジェクト)。
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
Key-Value に関連付けられたローカライズされたテキストの言語。値は、BCP-47 言語コードを含む文字列です。
localizations.(key).title string
ローカライズされた動画のタイトル。
localizations.(key).description string
ローカライズされた動画の説明。