2020 年 7 月 28 日以降に作成された未確認の API プロジェクトから
videos.insert
エンドポイントを介してアップロードされたすべての動画は、非公開視聴モードに制限されます。この制限を解除するには、各 API プロジェクトが監査を受け、利用規約を遵守していることを確認する必要があります。詳しくは、API の変更履歴をご覧ください。
video
リソースは YouTube 動画を表します。
Methods
API では、videos
リソースに対して以下のメソッドがサポートされています。
リソース表現
次の 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 動画が公開された日時。この時間は、動画がアップロードされた日時とは異なる場合があります。たとえば、動画が非公開動画としてアップロードされ、後で公開された場合、このプロパティでは動画が公開された日時を指定します。 次のような特別なケースがあります。
|
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 は次のとおりです。
|
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 文字です。文字数制限の計算方法については、次のルールに注意してください。
|
snippet.categoryId |
string 動画に関連付けられている YouTube 動画カテゴリ。 videos.update メソッドを呼び出し、video リソースの snippet 部分を更新する場合は、このプロパティの値を設定する必要があります。 |
snippet.liveBroadcastContent |
string 動画がライブ配信中またはライブ配信中かどうかを示します。動画が配信予定またはアクティブなライブ配信でない場合は、[なし] になります。 このプロパティの有効な値は次のとおりです。
|
snippet.defaultLanguage |
string video リソースの snippet.title プロパティと snippet.description プロパティのテキストの言語。 |
snippet.localized |
object snippet.localized オブジェクトには、ローカライズされた動画のタイトルと説明か、動画のメタデータのデフォルトの言語のタイトルが含まれます。
localizations オブジェクトを使用します。 |
snippet.localized.title |
string ローカライズした動画タイトル。 |
snippet.localized.description |
string ローカライズされた動画の説明。 |
snippet.defaultAudioLanguage |
string default_audio_language プロパティには、動画のデフォルトの音声トラックで話されている言語を指定します。 |
contentDetails |
object contentDetails オブジェクトには、動画の長さや字幕が表示されるかどうかなど、動画コンテンツに関する情報が格納されます。 |
contentDetails.duration |
string 動画の長さ。プロパティ値は ISO 8601 の期間です。たとえば、長さが 1 分以上 1 時間未満の動画では、 PT#M#S の形式で指定します。ここで値 PT には期間を指定し、M と S はそれぞれ分と秒の長さを示します。M 文字と S 文字に続く # 文字はどちらも、動画の時間(分)を示す整数です。たとえば、値 PT15M33S は、動画が 15 分 33 秒であることを示します。動画の長さが 1 時間以上の場合、再生時間の形式は PT#H#M#S です。H という文字の前の # は動画の長さを時間単位で指定し、その他の詳細情報はすべて上記と同じです。動画が 1 日以上の場合は、文字 P と T が区切ります。値の形式は P#DT#H#M#S です。詳しくは、ISO 8601 仕様をご覧ください。 |
contentDetails.dimension |
string 3D 版と 2D 版のどちらで動画が視聴できるかを示します。 |
contentDetails.definition |
string 動画の動画が高画質( HD )か標準画質のみかを示します。このプロパティの有効な値は次のとおりです。
|
contentDetails.caption |
string 動画に字幕を使用できるかどうかを指定します。 このプロパティの有効な値は次のとおりです。
|
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 のレーティングは、子ども向けテレビ番組の分類に使用されます。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.agcomRating |
string イタリアの Autorità per le Garanzie nelle Comunicazioni(AGCOM)の動画の評価です。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.anatelRating |
string チリのテレビにおける Anatel(Asociación Nacional de Televisión)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.bbfcRating |
string 動画の British Board of Film Classification(BBFC)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.bfvcRating |
string タイ映画委員会、動画検閲によるこの動画の評価。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.bmukkRating |
string オーストリアのメディア分類委員会(Bundesministerium für Unterricht、Kunst und Kultur)の動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.catvRating |
string カナダのテレビのレーティング システム - カナダのテレビ分類システム(カナダ英語放送のカナダ無線テレビ通信委員会(CRTC)による動画の評価)詳しくは、Canadian Broadcast Standards Council のウェブサイトをご覧ください。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.catvfrRating |
string カナダのフランス語放送局(CRTC)による、カナダのフランス語放送での動画のレーティング。詳しくは、Canadian Broadcast Standards Council のウェブサイトをご覧ください。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.cbfcRating |
string 動画の中心となる映像認証委員会(CBFC - インド)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.cccRating |
string Consejo de Calificación Cinematográfica(チリ)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.cceRating |
string ポルトガルの Comissão de Classificação de Espect ́culos による動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.chfilmRating |
string スイスにおける動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.chvrsRating |
string 動画の Canadian Home Video Rating System(CHVRS)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.cicfRating |
string Commission to Contrôle des Films(ベルギー)による動画のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.cnaRating |
string ルーマニアの CONSILIUL NATIONAL AL AUDIOVIZUALULUI(CNA)の動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.cncRating |
string フランスのレーティング システム - 委員会脱退映画撮影 このプロパティの有効な値:
|
contentDetails.contentRating.csaRating |
string フランスの Conseil supérieur de l?audiovisuel による動画の評価(放送コンテンツの評価)。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.cscfRating |
string ルクセンブルクのデータ保護に関する委員会(CSCF)によるレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.czfilmRating |
string チェコ共和国における動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.djctqRating |
string Departamento de Justiça, Classificação, Qualificação e Títulos(DJCQT - ブラジル)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.djctqRatingReasons[] |
list 動画が DJCQT(ブラジル)のレーティングを受けた理由。 |
contentDetails.contentRating.ecbmctRating |
string トルコの評価システム - 文化観光省評価および分類委員会 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.eefilmRating |
string エストニアにおける動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.egfilmRating |
string エジプトにおける動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.eirinRating |
string 映倫(レーティング)レーティング。映倫は日本のレーティング システムです。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.fcbmRating |
string マレーシアの映画検閲委員会による動画のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.fcoRating |
string 香港映画局(新聞・記事局)の動画に対する評価です。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.fmocRating |
string このプロパティは 2015 年 11 月 2 日に非推奨となりました。 contentDetails.contentRating.cncRating プロパティをご利用ください。動画センターの National du cinéma et de l'image animé(フランス文化省)の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.fpbRating |
string 南アフリカの映画・出版委員会による動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.fpbRatingReasons[] |
list 動画が FPB(南アフリカ)のレーティングを受けている理由。 |
contentDetails.contentRating.fskRating |
string Freiwillige Selbstkontrolle der Filmwirtschaft(FSK - ドイツ)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.grfilmRating |
string ギリシャにおける動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.icaaRating |
string Instituto de la Cinematografía y de las Artes Audiovisuales(ICAA - スペイン)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.ifcoRating |
string この動画は、アイルランドのフィルム分類局(IFCO - Ireland)のレーティングで、詳しくは、IFCO のウェブサイトをご覧ください。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.ilfilmRating |
string イスラエルにおける動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.incaaRating |
string 動画の INCAA(Instituto Nacional de Cine y Artes Audiovisuales - アルゼンチン)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.kfcbRating |
string ケニア映画分類委員会による動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media(オランダ)。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.kmrbRating |
string 韓国のメディア レーティング委員会(영영鉻鉻원新しい。KMRB は韓国の動画を評価しています。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.lsfRating |
string インドネシアの Lembaga センサー フィルムから得られた動画のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mccaaRating |
string Malta の Film Age Classification Board の動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mccypRating |
string デンマーク映画協会(Det Danske Filminstitut)Media Council for Children and Young People の動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mcstRating |
string ベトナム向け動画の評価システム - MCST このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mdaRating |
string この動画は、シンガポールのメディア開発庁(MDA)、特に映画監督委員会(BFC)によるレーティングです。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.medietilsynetRating |
string ノルウェーのメディア機関である Medietilsynet による動画のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mekuRating |
string フィンランドの Kansallinen Audiovisualinen Instituutti(国立視聴覚研究所)による動画のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mibacRating |
string イタリアの文化財・文化対策局による動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mocRating |
string 動画「コロンビア文化省(コロンビア)」のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.moctwRating |
string 台湾省文化部の動画の評価です。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mpaaRating |
string 動画の米国映画協会(MPAA)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mpaatRating |
string 映画の予告編とプレビューの米国映画協会のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mtrcbRating |
string 映画テレビ審査審査委員会(フィリピン)の動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.nbcRating |
string モルディブ国立分類局の動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.nfrcRating |
string ブルガリア国立映画センターの動画の評価です。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.nfvcbRating |
string ナイジェリア国立映画および検閲委員会による動画のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.nkclvRating |
string この動画は、ラトビア国立映画センターの Nacionãolais Kino centrs にレーティングされています。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.oflcRating |
string Office of Film and Literature Classification(OFLC - ニュージーランド)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.pefilmRating |
string ペルーにおける動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.resorteviolenciaRating |
string ベネズエラにおける動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.rtcRating |
string この動画のラジオ、テレビ、映画撮影総局(メキシコ)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.rteRating |
string この動画は、アイルランドの Raidió Teilifís Éireann の動画に対する評価です。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.russiaRating |
string この動画は、ロシア連邦共和国の MKRF(National Film Registry)のレーティングです。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.skfilmRating |
string スロバキアにおける動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.smaisRating |
string アイスランドにおける動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.smsaRating |
string Statens medieråd(スウェーデンの National Media Council)の動画の評価。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.tvpgRating |
string 動画の TV Parental Guidelines(TVPG)のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.ytRating |
string YouTube が年齢制限のあるコンテンツを識別するために使用するレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.projection |
string 動画の投影形式を指定します。 このプロパティの有効な値は次のとおりです。
|
contentDetails.hasCustomThumbnail |
boolean 動画をアップロードしたユーザーが動画にカスタム サムネイル画像を提供したかどうかを示します。このプロパティは、動画をアップロードしたユーザーにのみ表示されます。 |
status |
object status オブジェクトには、動画のアップロード、処理、プライバシーのステータスに関する情報が格納されます。 |
status.uploadStatus |
string アップロードされた動画のステータス。 このプロパティの有効な値は次のとおりです。
|
status.failureReason |
string この値は、動画のアップロードに失敗した理由を表します。このプロパティは、 uploadStatus プロパティがアップロードの失敗を示している場合にのみ存在します。このプロパティの有効な値は次のとおりです。
|
status.rejectionReason |
string この値は、アップロードされた動画が YouTube で拒否された理由を示しています。このプロパティは、 uploadStatus プロパティがアップロードの拒否を示している場合にのみ存在します。このプロパティの有効な値は次のとおりです。
|
status.privacyStatus |
string 動画のプライバシー ステータス。 このプロパティの有効な値は次のとおりです。
|
status.publishAt |
datetime 動画の公開日時。動画のプライバシー ステータスが非公開である場合にのみ設定できます。値は ISO 8601 形式で指定します。このプロパティの動作については、さらに次の 2 つの点に注意してください。
|
status.license |
string 動画のライセンス。 このプロパティの有効な値は次のとおりです。
|
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> タグです。 |
player.embedHeight |
long player.embedHtml プロパティで返される埋め込みプレーヤーの高さ。このプロパティは、リクエストで maxHeight パラメータまたは maxWidth パラメータに値が指定され、動画のアスペクト比がわかっている場合にのみ返されます。 |
player.embedWidth |
long player.embedHtml プロパティで返される埋め込みプレーヤーの幅。このプロパティは、リクエストで maxHeight パラメータまたは maxWidth パラメータに値が指定され、動画のアスペクト比がわかっている場合にのみ返されます。 |
topicDetails |
object topicDetails オブジェクトは、動画に関連付けられているトピックに関する情報をカプセル化します。重要: トピック ID に関連する今後の変更について詳しくは、 topicDetails.relevantTopicIds[] プロパティと topicDetails.topicIds[] プロパティの定義および変更履歴をご覧ください。 |
topicDetails.topicIds[] |
list 重要: このプロパティは 2016 年 11 月 10 日をもって非推奨となりました。この API は、このプロパティの値を返さなくなりました。動画に関連付けられているすべてのトピックは、 topicDetails.relevantTopicIds[] プロパティ値によって返されるようになりました。 |
topicDetails.relevantTopicIds[] |
list 動画に関連するトピック ID のリスト。 このプロパティは 2016 年 11 月 10 日をもって非推奨となりました。2017 年 11 月 10 日までサポートされます。 重要: Freebase と Freebase API のサポート終了に伴い、2017 年 2 月 27 日をもって、トピック ID の動作が変更されました。その時点で、YouTube は少数の厳選されたトピック ID を返し始めました。 |
topicDetails.topicCategories[] |
list ウィキペディアの URL のリストで、動画の内容の概要を提供します。 |
recordingDetails |
object recordingDetails オブジェクトは、動画が撮影された場所、日付、住所に関する情報をカプセル化します。 |
recordingDetails.locationDescription |
string このプロパティは 2017 年 6 月 1 日をもって非推奨となりました。詳しくは、サポート終了のお知らせをご覧ください。 動画が撮影された場所の説明。 |
recordingDetails.location |
object 動画に関連付けられている位置情報。子プロパティの値は、動画の所有者が動画に関連付ける場所を識別します。この値は、公開動画では編集、検索が可能で、公開動画のユーザーには表示されることがあります。 |
recordingDetails.location.latitude |
double このプロパティは 2017 年 6 月 1 日をもって非推奨となりました。詳しくは、サポート終了のお知らせをご覧ください。 緯度。 |
recordingDetails.location.longitude |
double このプロパティは 2017 年 6 月 1 日をもって非推奨となりました。詳しくは、サポート終了のお知らせをご覧ください。 度数(度)。 |
recordingDetails.location.altitude |
double このプロパティは 2018 年 7 月 9 日に非推奨となりました。詳しくは、サポート終了のお知らせをご覧ください。 参照楕円体の高度(メートル単位)。 |
recordingDetails.recordingDate |
datetime 動画が録画された日時。この値は ISO 8601( YYYY-MM-DDThh:mm:ss.sssZ )形式で指定します。 |
fileDetails |
object fileDetails オブジェクトは、ファイルの解像度、長さ、音声と動画のコーデック、ストリーム ビットレートなど、YouTube にアップロードされた動画ファイルに関する情報をカプセル化します。このデータを取得できるのは動画の所有者のみです。fileDetails オブジェクトは、processingDetails.fileAvailability プロパティの値が available の場合にのみ返されます。 |
fileDetails.fileName |
string アップロードされたファイルの名前。このフィールドは、アップロードされたのが動画ファイルか別のタイプのファイルかに関係なく存在します。 |
fileDetails.fileSize |
unsigned long アップロードされたファイルのサイズ(バイト単位)。このフィールドは、アップロードされたのが動画ファイルか別のタイプのファイルかに関係なく存在します。 |
fileDetails.fileType |
string YouTube の動画処理エンジンが検出した、アップロードされたファイルの種類。現在、YouTube は動画ファイルのみを処理しますが、このフィールドには動画ファイルか別のタイプのファイルがアップロードされたかが示されます。 このプロパティの有効な値は次のとおりです。
|
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 が元のコンテンツを回転させるために必要な量。 このプロパティの有効な値は次のとおりです。
|
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 形式がサポートされています。
|
processingDetails |
object processingDetails オブジェクトは、アップロードされた動画ファイルの処理における YouTube の進行状況に関する情報をカプセル化します。このオブジェクトのプロパティは、現在の処理ステータスと、YouTube が動画の処理を完了するまでの予想残り時間を表します。また、この部分は、ファイルの詳細やサムネイル画像など、さまざまなタイプのデータやコンテンツを動画で利用できるかどうかも示しています。processingProgress オブジェクトは、アップロード対象の動画のファイル処理における YouTube の進行状況を追跡できるように、ポーリングを行うように設計されています。このデータを取得できるのは動画の所有者のみです。 |
processingDetails.processingStatus |
string 動画の処理ステータス。この値は、YouTube が動画を処理できたか、または処理中かどうかを示します。 このプロパティの有効な値は次のとおりです。
|
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 の場合にのみ値が設定されます。このプロパティの有効な値は次のとおりです。
|
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 になることを示しています。このプロパティの有効な値は次のとおりです。
|
suggestions.processingWarnings[] |
list アップロードした動画のトランスコードが YouTube でうまくいかない、または誤った変換が行われる理由のリスト。このような警告は、YouTube が実際にアップロード済み動画ファイルを処理する前に生成されます。また、動画処理の失敗を示すとは限らないが、同期の問題、動画アーティファクト、音声トラックの欠落などの原因となる可能性がある問題も特定されます。 このプロパティの有効な値は次のとおりです。
|
suggestions.processingHints[] |
list YouTube での動画処理能力が向上する可能性があるヒントのリストです。 このプロパティの有効な値は次のとおりです。
|
suggestions.tagSuggestions[] |
list 動画のメタデータに追加できるキーワード タグのリスト。ユーザーが YouTube を検索またはブラウジングするときに動画が見つけられる可能性が高まります。 |
suggestions.tagSuggestions[].tag |
string 動画の推奨キーワードタグ。 |
suggestions.tagSuggestions[].categoryRestricts[] |
list タグが関連している一連の動画カテゴリ。この情報を使用すると、動画をアップロードしたユーザーが動画に関連付けた動画カテゴリに基づいて、適切なタグの提案を表示することができます。キーワードに対する制限が設定されていない場合、デフォルトではタグの提案にはすべてのカテゴリが該当します。 |
suggestions.editorSuggestions[] |
list アップロードした動画の画質や再生エクスペリエンスを改善する動画編集操作のリスト。 このプロパティの有効な値は次のとおりです。
|
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 ローカライズされた動画の説明。 |