Videos

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

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

Methods

API では、videos リソースに対して以下のメソッドがサポートされています。

getRating
指定されたユーザーが指定された動画のリストに対して付けた評価を取得します。今すぐ試す
list
API リクエスト パラメータに一致する動画のリストを返します。 今すぐ試す
挿入
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
有効な Key-Value は次のとおりです。
  • default – デフォルトのサムネイル画像。動画(または、再生リストのアイテムや検索結果など、動画を参照するリソース)のデフォルト サムネイルは幅 120px、高さ 90px です。チャンネルのデフォルト サムネイルは幅 88px、高さ 88px です。
  • medium – サムネイル画像の高解像度バージョン。動画(または動画を参照するリソース)の場合、この画像は幅 320px、高さ 180px です。チャンネルの場合は、幅 240px、高さ 240px です。
  • high – サムネイル画像の高解像度バージョン。動画(または動画を参照するリソース)の場合、この画像は幅 480px、高さ 360px です。チャンネルの場合、幅 800px、高さ 800px です。
  • standardhigh 画像よりもさらに高い解像度のサムネイル画像です。この画像は、再生リストのアイテムや検索結果など、動画を参照する一部の動画やその他のリソースで利用できます。この画像は幅 640 px、高さ 480 px です。
  • maxres - サムネイル画像の最高バージョン。この画像サイズは、再生リストの動画や検索結果など、動画を参照する一部の動画やリソースで利用できます。この画像は幅 1,280 px、高さ 720 px です。
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 タグには 9 文字が含まれていますが、Foo Baz タグには 9 文字という文字数制限があります。
snippet.categoryId string
動画に関連付けられている YouTube 動画カテゴリvideos.update メソッドを呼び出し、video リソースの snippet 部分を更新する場合は、このプロパティの値を設定する必要があります。
snippet.liveBroadcastContent string
動画がライブ配信中またはライブ配信中かどうかを示します。動画が配信予定またはアクティブなライブ配信でない場合は、[なし] になります。

このプロパティの有効な値は次のとおりです。
  • 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à per le Garanzie nelle Comunicazioni(AGCOM)の動画の評価です。

このプロパティの有効な値は次のとおりです。
  • agcomT~ T
  • agcomUnrated
  • agcomVm14 - VM14
  • agcomVm18 - VM18
contentDetails.contentRating.anatelRating string
チリのテレビにおける Anatel(Asociación Nacional de Televisión)のレーティング。

このプロパティの有効な値は次のとおりです。
  • anatelA~ A
  • anatelF~ F
  • anatelI~ I
  • anatelI10~ I-10
  • anatelI12~ I-12
  • anatelI7~ I-7
  • anatelR~ R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
動画の British Board of Film Classification(BBFC)のレーティング。

このプロパティの有効な値は次のとおりです。
  • bbfc12~ 12
  • bbfc12a~ 12A
  • bbfc15~ 15
  • bbfc18~ 18
  • bbfcPg~ PG
  • bbfcR18~ R18
  • bbfcU~ U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
タイ映画委員会、動画検閲によるこの動画の評価。

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

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

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

このプロパティの有効な値は次のとおりです。
  • catvfr13plus~ 13 歳以上
  • catvfr16plus~ 16 歳以上
  • catvfr18plus~ 18 歳以上
  • catvfr8plus~ 8 以上
  • catvfrG~ G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
動画の中心となる映像認証委員会(CBFC - インド)のレーティング。

このプロパティの有効な値は次のとおりです。
  • cbfcA~ A
  • cbfcS~ S
  • cbfcU~ U
  • cbfcUnrated
  • cbfcUA~ U/A
  • cbfcUA7plus~ U/A
  • cbfcUA13plus~ U/A
  • cbfcUA16plus~ U/A
contentDetails.contentRating.cccRating string
Consejo de Calificación Cinematográfica(チリ)のレーティング。

このプロパティの有効な値は次のとおりです。
  • ccc14~ 14 歳以上
  • ccc18~ 18 歳以上
  • ccc18s - 18 歳以上 - contenido pornográfico
  • ccc18v – 18 歳以上 - contenido excesivamenteviolo
  • ccc6 – 6+ - コンビニェンス パラ メノール ド 7 アニョス
  • cccTe - ToDo エスカドーター
  • 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
Commission to 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
ルクセンブルクのデータ保護に関する委員会(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~ 7 時
  • ecbmct7plus~ 7 以上
  • ecbmctG~ G
  • ecbmctUnrated
  • ecbmct6a~ 6 A
  • ecbmct6plus~ 6 以上
  • ecbmct10a~ 10A
  • ecbmct10plus~ 10 以上
  • ecbmct16plus~ 16 歳以上
contentDetails.contentRating.eefilmRating string
エストニアにおける動画の評価。

このプロパティの有効な値は次のとおりです。
  • eefilmK12~ K-12
  • eefilmK14~ K-14
  • eefilmK16~ K-16
  • eefilmK6~ K-6
  • eefilmL~ L
  • eefilmMs12 - MS-12
  • eefilmMs6 - MS-6
  • eefilmPere - ピア
  • 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
マレーシアの映画検閲委員会による動画のレーティング。

このプロパティの有効な値は次のとおりです。
  • fcbm18~ 18
  • fcbm18pa~ 18PA
  • fcbm18pl~ 18 PL
  • fcbm18sg~ 18 SG
  • fcbm18sx~ 18 秒
  • fcbmP13~ P13
  • fcbmPg13~ PG13
  • fcbmU~ U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
香港映画局(新聞・記事局)の動画に対する評価です。

このプロパティの有効な値は次のとおりです。
  • fcoI~ I
  • fcoIi~ II
  • fcoIia~ IIA
  • fcoIib~ IB
  • 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
南アフリカの映画・出版委員会による動画の評価。

このプロパティの有効な値は次のとおりです。
  • fpb10~ 10
  • fpb1012Pg~ 10 ~ 12 PG
  • fpb13~ 13
  • fpb16~ 16
  • fpb18~ 18
  • fpb79Pg~ 7 ~ 9 PG
  • fpbA~ A
  • fpbPg~ PG
  • fpbUnrated
  • fpbX18~ X18
  • fpbXx~ XX
contentDetails.contentRating.fpbRatingReasons[] list
動画が FPB(南アフリカ)のレーティングを受けている理由。
contentDetails.contentRating.fskRating string
Freiwillige Selbstkontrolle der Filmwirtschaft(FSK - ドイツ)のレーティング。

このプロパティの有効な値は次のとおりです。
  • fsk0 - FSK 0
  • fsk12 - FSK 12
  • fsk16 - FSK 16
  • fsk18 - FSK 18
  • fsk6 - FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
ギリシャにおける動画の評価。

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

このプロパティの有効な値は次のとおりです。
  • icaa12~ 12
  • icaa13~ 13
  • icaa16~ 16
  • icaa18~ 18
  • icaa7~ 7
  • icaaApta - APTA
  • icaaUnrated
  • icaaX~ X
contentDetails.contentRating.ifcoRating string
この動画は、アイルランドのフィルム分類局(IFCO - Ireland)のレーティングで、詳しくは、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 - アルゼンチン)のレーティング。

このプロパティの有効な値は次のとおりです。
  • incaaAtp - ATP(Apta para Todo public)
  • 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
  • kijkwijzer16~ 16
  • kijkwijzer18~ 18
  • kijkwijzer6~ 6
  • kijkwijzer9~ 9
  • kijkwijzerAl~アラブ
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
韓国のメディア レーティング委員会(영영鉻鉻원新しい。KMRB は韓国の動画を評価しています。

このプロパティの有効な値は次のとおりです。
  • kmrb12plus – 12 点単体また一元化
  • kmrb15plus - 15 いて死亡するかもんでいない
  • kmrbAll - BackendConfig 체터 RENDERED
  • 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
Malta の 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)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
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 Audiovisualinen Instituutti(国立視聴覚研究所)による動画のレーティング。

このプロパティの有効な値は次のとおりです。
  • meku12~ 12
  • meku16~ 16
  • meku18~ 18
  • meku7~ 7
  • mekuS~ S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
イタリアの文化財・文化対策局による動画の評価。

このプロパティの有効な値は次のとおりです。
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
動画「コロンビア文化省(コロンビア)」のレーティング。

このプロパティの有効な値は次のとおりです。
  • moc12~ 12
  • moc15~ 15
  • moc18~ 18
  • moc7~ 7
  • mocBanned - 禁止
  • mocE~ E
  • mocT~ T
  • mocUnrated
  • mocX~ X
contentDetails.contentRating.moctwRating string
台湾省文化部の動画の評価です。

このプロパティの有効な値は次のとおりです。
  • moctwG~ G
  • moctwP~ P
  • moctwPg~ PG
  • moctwR~ R
  • moctwR12~ R-12
  • moctwR15~ R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
動画の米国映画協会(MPAA)のレーティング。

このプロパティの有効な値は次のとおりです。
  • mpaaG~ G
  • mpaaNc17~ NC-17
  • mpaaPg~ PG
  • mpaaPg13~ PG-13
  • mpaaR~ R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
映画の予告編とプレビューの米国映画協会のレーティング。

このプロパティの有効な値は次のとおりです。
  • mpaatGb~ GB(グリーンバンド - すべてのオーディエンスに対して承認済み)
  • mpaatRb – RB(レッドバンド - 17 歳以上に推奨)
contentDetails.contentRating.mtrcbRating string
映画テレビ審査審査委員会(フィリピン)の動画の評価。

このプロパティの有効な値は次のとおりです。
  • mtrcbG~ G
  • mtrcbPg~ PG
  • mtrcbR13~ R-13
  • mtrcbR16~ R-16
  • mtrcbR18~ R-18
  • mtrcbUnrated
  • mtrcbX~ X
contentDetails.contentRating.nbcRating string
モルディブ国立分類局の動画の評価。

このプロパティの有効な値は次のとおりです。
  • 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~ 12A
  • nfvcb15~ 15
  • nfvcb18~ 18
  • nfvcbG~ G
  • nfvcbPg~ PG
  • nfvcbRe~ RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
この動画は、ラトビア国立映画センターの Nacionãolais Kino centrs にレーティングされています。

このプロパティの有効な値は次のとおりです。
  • nkclv12plus~ 12 以上
  • nkclv18plus~ 18 歳以上
  • nkclv7plus~ 7 以上
  • nkclvU~ U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Office of Film and Literature Classification(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~スイス
  • rteGa~ GA
  • rteMa~マサチューセッツ州
  • rtePs~ PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
この動画は、ロシア連邦共和国の MKRF(National Film Registry)のレーティングです。

このプロパティの有効な値は次のとおりです。
  • 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 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 プロパティを過去の日時に設定した場合の効果は、動画の 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 リクエストで、maxHeightmaxWidth パラメータの値が指定されている場合、埋め込みプレーヤーのサイズは、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
動画を適切に表示するために 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 の進行状況に関する情報をカプセル化します。このオブジェクトのプロパティは、現在の処理ステータスと、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 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
ローカライズされた動画の説明。