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 動画が近日配信または実施中のライブ配信かどうかを示します。今後、または現在配信中のライブ ブロードキャストでない場合は、「none」になります。 このプロパティで有効な値は次のとおりです。
|
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à による 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 Canadian TV のレーティング システム - Canadian TV Classification System カナダの英語放送を対象としたカナダのラジオテレビおよび電気通信委員会(CRTC)による動画のレーティングです。詳しくは、Canadian Broadcast Standards Council のウェブサイトをご覧ください。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.catvfrRating |
string カナダのフランス語放送に対するカナダの無線テレビおよび電気通信委員会(CRTC)による動画のレーティング。詳しくは、Canadian Broadcast Standards Council のウェブサイトをご覧ください。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.cbfcRating |
string 動画の Central Board of Film Certification(CBFC - India)によるレーティング。 このプロパティで有効な値は次のとおりです。
|
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 de 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 ルクセンブルクの Commission de surveillance de laClassification des Films(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 南アフリカの Film and Publication Board による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
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 Irish Film Classification Office(IFCO - アイルランド)による動画のレーティング。詳細については、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 マルタの映画年齢分類委員会による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.mccypRating |
string Danish Film Institute(Det Danske Filminstitut)Media Council for Children and Young People による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.mcstRating |
string ベトナムにおける動画のレーティング システム - MCST このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.mdaRating |
string シンガポールのメディア開発庁(MDA)、具体的には Board of Film Censors(BFC)による動画のレーティングです。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.medietilsynetRating |
string ノルウェーのメディア庁である Medietilsynet による動画のレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.mekuRating |
string フィンランドの Kansallinen Audiovisualinen Instituutti(National Audiovisual Institute)による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.mibacRating |
string Ministero dei Beni e delle Attività Culturali e del Turismo(イタリア)による動画の評価です。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.mocRating |
string 動画の Ministerio de Cultura(コロンビア)によるレーティング。 このプロパティの有効な値は次のとおりです。
|
contentDetails.contentRating.moctwRating |
string 台湾の文化部(文化部)による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.mpaaRating |
string 米国の映画協会(MPAA)による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.mpaatRating |
string 映画の予告編とプレビューに対する全米映画協会の評価。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.mtrcbRating |
string Movie and Television Review and Classification Board(フィリピン)による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.nbcRating |
string モルディブ国家分類局による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.nfrcRating |
string ブルガリア国立映画センターによる動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.nfvcbRating |
string ナイジェリアの国立映画監督庁による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.nkclvRating |
string Nacionólais Kino centrs(ラトビア国立映画センター)による動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.oflcRating |
string 動画の映画・文学分類局(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 - ロシア)のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.skfilmRating |
string スロバキアでの動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.smaisRating |
string アイスランドでの動画のレーティング。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.smsaRating |
string Statens medieråd(スウェーデンの National Media Council)による動画の評価。 このプロパティで有効な値は次のとおりです。
|
contentDetails.contentRating.tvpgRating |
string 動画の TV 保護者による使用制限(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 動画を適切に表示するために、元のソース コンテンツを回転させるために必要な量です。 このプロパティで有効な値は次のとおりです。
|
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 は配信の同時視聴者数のトラッキングを停止します。そのため、このプロパティでは、ライブ配信がすでに終了し、アーカイブされた動画を視聴している視聴者の数は識別されません。 YouTube Data API が返す同時視聴者数は、YouTube アナリティクスで確認可能な、処理済みでスパム除去された同時視聴者数とは異なる場合があります。ライブ配信の指標について詳しくは、YouTube ヘルプセンターをご覧ください。
|
liveStreamingDetails.activeLiveChatId |
string この動画に関連付けられている現在アクティブなチャットの ID。このフィールドは、動画が現在チャットを含むライブ配信の場合にのみ入力されます。配信が終了してこのフィールドが入力されると、チャットは終了します。常時配信の場合、チャット ID はこの動画ではなく、固定ページに表示される新しい動画と関連付けられます。 |
localizations |
object localizations オブジェクトには、動画のメタデータの翻訳が格納されます。 |
localizations.(key) |
object キー値に関連付けられているローカライズされたテキストの言語。値は、BCP-47 言語コードを含む文字列です。 |
localizations.(key).title |
string ローカライズされた動画のタイトル。 |
localizations.(key).description |
string ローカライズされた動画の説明。 |