このページには、YouTube Data API(v3)の変更点とドキュメントの更新内容が掲載されています。この変更ログの登録。
2024 年 10 月 30 日
この API では、リアルな改変または合成(A/S)コンテンツを含む動画を識別できるようになりました。詳しくは、A/S コンテンツに関する YouTube ポリシーをご覧ください。
A/S コンテンツの例としては、次のような動画が挙げられます。
- 実在の人物が実際には発言または行動していないことを、発言または行動しているように見せている
- 実際の出来事や場所の映像を改変している
- 実際には起きていない場面が本物のように見えるものを生成する
動画に A/S コンテンツが含まれているかどうかを示すには、status.containsSyntheticMedia
プロパティを設定します。このプロパティは、videos.insert
メソッドまたは videos.update
メソッドを呼び出すときに設定できます。設定すると、video
リソースでプロパティが返されます。
2024 年 4 月 30 日
注: これは非推奨のお知らせです。
この改訂での変更内容は次のとおりです:
API では、チャンネルのディスカッションを挿入または取得する機能がサポートされなくなりました。この変更は YouTube ウェブサイトでサポートされている機能と一致します。YouTube ウェブサイトでサポートされている機能はチャンネルにコメントを投稿できません。
2024 年 3 月 13 日
注: これは非推奨のお知らせです。
この改訂での変更内容は次のとおりです:
captions.insert
メソッドと captions.update
メソッドの sync
パラメータは非推奨になりました。このパラメータのサポートは、2024 年 4 月 12 日をもって終了します。
この変更に伴い、デベロッパーは字幕トラックを挿入または更新する際にタイミング情報を含める必要があります。指定しない場合、アップロードは失敗します。
2024 年 3 月 12 日
この改訂での変更内容は次のとおりです:
captions
リソースのドキュメントが更新され、snippet.name
フィールドの最大長が 150 文字であることが記載されました。トラック名がそれより長い場合、API は nameTooLong
エラーを返します。
2024 年 3 月 7 日
注: これはサポート終了のお知らせです。
channel
リソース プロパティ brandingSettings.channel.moderateComments
のサポートが終了しました。このパラメータのサポートは、2024 年 3 月 7 日をもって終了します。
2024 年 1 月 31 日
この改訂での変更内容は次のとおりです:
channels.list
メソッドの新しい forHandle
パラメータを使用すると、YouTube ハンドルを指定してチャンネルに関する情報を取得できます。
2023 年 11 月 9 日
videoId
リソースが API 呼び出しを使用して返されなくなったため、Comments
の videoId
リソースへの参照がすべて削除されました。
2023 年 9 月 12 日
注: これは非推奨のお知らせです。
comments.markAsSpam
メソッドは数年前に非推奨になりました。この方法はすでに YouTube でサポートされておらず、API でもサポートされなくなりました。
comments.markAsSpam
メソッドを参照するすべてのドキュメントに非推奨通知が追加されました。
2023 年 8 月 22 日
search.list
メソッドが videoPaidProductPlacement
パラメータをサポートするようになりました。このパラメータを使用すると、クリエイターが有料プロモーションとして指定した動画のみを検索結果に含めるようにフィルタできます。
2023 年 8 月 18 日
video
リソースの liveStreamingDetails.concurrentViewers
の定義が更新され、YouTube Data API から返される同時視聴者数と、YouTube アナリティクスで確認可能な処理済み、スパム除去後の同時視聴者数が異なる場合があります。ライブ配信の指標について詳しくは、YouTube ヘルプセンターをご覧ください。
2023 年 8 月 7 日
2023 年 6 月 12 日にお知らせしましたとおり、search.list
メソッドの relatedToVideoId
パラメータは非推奨となりました。このパラメータはサポートが終了したため、API ドキュメントからパラメータへの参照が削除されました。
2023 年 6 月 28 日
thumbnails.set メソッドで、過去 24 時間にチャンネルでアップロードされたサムネイルが多すぎることを示す uploadRateLimitExceeded
エラーがサポートされるようになりました。
2023 年 6 月 12 日
注: これはサポート終了のお知らせです。
search.list メソッドの relatedToVideoId
パラメータは非推奨になりました。YouTube は、2023 年 8 月 7 日をもってこのパラメータのサポートを終了します。
現時点で、search.list
メソッドのドキュメントにサポート終了のお知らせが追加されました。このパラメータは、2023 年 8 月 7 日以降、search.list
のドキュメントから完全に削除されます。
また、関連動画を取得する方法の例が API 実装ガイドから削除されました。
2022 年 8 月 22 日
video.statistics フィールドの型アノテーションを unsigned long から文字列に修正しました。
2022 年 8 月 5 日
YouTube は字幕 ID の生成方法を変更しました。その変更の一環として、すべての字幕トラックに新しい字幕 ID が割り当てられます。この変更は、caption_id
値を保存するアプリに対して下位互換性のない変更になる可能性がありますが、caption_id
値を保存しないアプリには影響しません。
現在から 2022 年 12 月 1 日まで、captions.list
、captions.update
、captions.download
、captions.delete
の各メソッドで新旧両方の字幕トラック ID がサポートされます。ただし、2022 年 12 月 1 日以降、YouTube は古い字幕トラック ID のサポートを停止します。その時点で、古い字幕トラック ID を使用してこれらの API メソッドを呼び出すと、captionNotFound
エラーが発生します。
この変更に備えて、2022 年 12 月 1 日までに、保存されているすべての字幕トラック データを完全に置き換える必要があります。つまり、字幕トラック データを保存する動画については、現在保存されているデータを削除してから、captions.list
メソッドを呼び出して動画の現在の字幕トラック セットを取得し、通常どおりに API レスポンスにデータを保存する必要があります。
2022 年 7 月 12 日
YouTube API サービスの利用規約が更新されました。詳しくは、YouTube API サービスの利用規約 - 改訂履歴をご覧ください。
2022 年 4 月 27 日
videos.insert
メソッドの説明を更新し、アップロードする動画の最大ファイルサイズが 128 GB から 256 GB に引き上げられたことを記載しました。
2022 年 4 月 8 日
subscriptions.list
メソッドの myRecentSubscribers
パラメータと mySubscribers
パラメータの定義の両方が更新され、API によって返されるサブスクライバーの最大数が制限される可能性があることに留意してください。この変更はドキュメントの修正を示すものであり、API の動作を変更するものではありません。
2021 年 12 月 15 日
2021 年 11 月 18 日にお知らせしたとおり、YouTube プラットフォーム全体で動画の低評価数を非公開にする変更に伴い、video
リソースの statistics.dislikeCount
プロパティが非公開になりました。
この変更について詳しくは、YouTube の公式ブログをご覧ください。
2021 年 11 月 18 日
YouTube プラットフォーム全体で動画の低評価数が非公開になる変更に伴い、video
リソースの statistics.dislikeCount
プロパティは 2021 年 12 月 13 日をもって非公開になります。つまり、API リクエストが動画の所有者によって認証されている場合にのみ、videos.list
エンドポイントからの API レスポンスにプロパティが含まれます。
videos.rate
エンドポイントはこの変更の影響を受けません。
低評価数を公開せずに、API クライアントで低評価数を必要とするデベロッパーは、例外として許可リストに登録するよう申請できます。免除を申請するには、こちらの申請フォームに記入する必要があります。
この変更について詳しくは、YouTube の公式ブログをご覧ください。
2021 年 7 月 2 日
注: これは非推奨のお知らせです。
commentThreads.update
エンドポイントは非推奨になり、サポートされなくなりました。このエンドポイントは、他の API エンドポイントで利用可能な機能を複製していました。代わりに、comments.update
を呼び出すことができます。
commentThreads
リソースが必要な場合は、commentThreads.list
メソッドを 2 回呼び出します。
2021 年 7 月 1 日
YouTube の API サービスを使用しているすべてのデベロッパーは、デフォルトの割り当てである 10,000 ユニットを超える割り当てを取得するには、API コンプライアンス監査を完了する必要があります。これまで、コンプライアンス監査プロセスと追加の割り当て単位の割り当てリクエストは、デベロッパーが YouTube API サービス - 監査と割り当て増加フォームに記入して送信することで行われてきました。
これらのプロセスを明確にし、API サービスを利用するデベロッパーのニーズをよりよく満たすため、3 つの新しいフォームと、それらのフォームへの記入ガイドを追加します。
- 監査対象デベロッパー リクエスト フォーム: すでに API コンプライアンス監査に合格しているデベロッパーは、こちらの簡単なフォームに入力して送信し、割り当てられた割り当ての延長をリクエストできます。
- 再審査請求フォーム: API プロジェクトがコンプライアンス監査に不合格となった(または割り当て単位の増加が拒否された)デベロッパーは、このフォームに必要事項を入力して送信できます。
- 支配権の変更フォーム: API プロジェクトに関連する支配権の変更(株式の売買、合併、その他の企業取引など)が発生したデベロッパーまたはデベロッパーに代わって API クライアントを運営する当事者は、このフォームに記入して送信する必要があります。これにより、YouTube の API チームは、記録の更新、新しい API プロジェクトのユースケースのコンプライアンスの監査、デベロッパーの現在の割り当て割り当ての検証を行うことができます。
それぞれの新しいフォームで、お客様が YouTube の API の意図する使用目的を把握し、より適切なサポートをご提供できるようご協力ください。
詳しくは、新しい API コンプライアンス監査のガイドをご覧ください。
2021 年 5 月 12 日
注: これは非推奨のお知らせです。
この更新には、次の API の変更が含まれます。
-
channel
リソースのcontentDetails.relatedPlaylists.favorites
プロパティのサポートが終了しました。お気に入りの動画機能は、2016 年 4 月 28 日の変更履歴エントリに記載されているとおり、すでに数年間サポートを終了しています。この更新前は、API クライアントが存在しないお気に入り プレイリストに動画を追加しようとした場合でも、API は新しいプレイリストを作成していました。今後、この場合再生リストは作成されず、API からエラーが返されます。アイテムを追加、変更、削除してお気に入りのプレイリストを変更しようとした場合も、以前のお知らせに従ってすべてサポートを終了し、いつでもエラーが返される可能性があります。
-
次の
channel
リソース プロパティは非推奨になりました。これらのプロパティは、YouTube Studio の UI と YouTube ですでにサポートされていません。そのため、API を介したサポートも終了しました。brandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
すべてのプロパティは
channel
リソース表現から削除され、その定義はリソースのプロパティ リストから削除されました。また、これらのプロパティに関連するエラーは、メソッド固有のドキュメントから削除されました。 -
次の
channelSection
リソース プロパティは非推奨になりました。これらのプロパティは、YouTube Studio の UI と YouTube ではすでにサポートされていません。そのため、API を介したサポートも終了しました。snippet.style
snippet.defaultLanguage
snippet.localized.title
localizations
localizations.(key)
localizations.(key).title
targeting
targeting.languages[]
targeting.regions[]
targeting.countries[]
この変更に伴い、
channelSection.list
メソッドのhl
パラメータも非推奨になりました。このパラメータがサポートする機能がサポートされていないためです。すべてのプロパティが
channelSection
リソース表現から削除され、その定義がリソースのプロパティ リストから削除されました。また、これらのプロパティに関連するエラーは、メソッド固有のドキュメントから削除されました。 -
channelSection
リソースのsnippet.type
プロパティでは、次の値が非推奨になりました。これらの値はすでに YouTube チャンネル ページではサポートされていないため、API でもサポートされなくなりました。likedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
playlist
リソースのsnippet.tags[]
プロパティのサポートが終了しました。このプロパティはすでに YouTube でサポートされていないため、API ではサポートされなくなりました。
2021 年 2 月 9 日
playlistItem
リソースでは、次の 2 つの新しいプロパティがサポートされています。
snippet.videoOwnerChannelId
プロパティは、再生リストの動画をアップロードしたチャンネルの ID を識別します。snippet.videoOwnerChannelTitle
プロパティは、再生リストの動画をアップロードしたチャンネルの名前を示します。
2021 年 1 月 28 日
この改訂での変更内容は次のとおりです:
-
playlistItems.delete
、playlistItems.insert
、playlistItems.list
、playlistItems.update
、playlists.delete
、playlists.list
、playlists.update
の各メソッドは、すべて新しいplaylistOperationUnsupported
エラーをサポートします。このエラーは、特定の再生リストで許可されていないオペレーションがリクエストを実行しようとした場合に発生します。たとえば、ユーザーがアップロードした動画の再生リストから動画を削除したり、再生リスト自体を削除したりすることはできません。いずれの場合も、このエラーは
400
HTTP レスポンス コード(不正なリクエスト)を返します。 -
playlistItems.list
メソッドのwatchHistoryNotAccessible
エラーとwatchLaterNotAccessible
エラーがドキュメントから削除されました。ユーザーの再生履歴や後で見るリストなどに API でアクセスすることはできませんが、このようなエラーは API から返されません。
2020 年 10 月 15 日
デベロッパー ポリシーに、次の 2 つの新しいセクションが追加されました。
- 新しい セクション III.E.4.i では、YouTube 埋め込みプレーヤーを介して収集、送信されるデータに関する追加情報を提供しています。お客様は、ユーザーが再生意図を示すためにプレーヤーを操作する前に YouTube 埋め込みプレーヤーを介して YouTube に送信されたユーザーデータについて責任を負います。自動再生を false に設定すると、ユーザーがプレーヤーを操作する前に YouTube と共有されるデータを制限できます。
- 新しい セクション III.E.4.j は、サイトやアプリに埋め込む前にコンテンツの子ども向け(MFK)ステータスを確認することに関するものです。API クライアントに埋め込んだ動画が子ども向けかどうかを把握し、それに応じて埋め込みプレーヤーから収集したデータを扱うことは、お客様の責任となります。そのため、YouTube 埋め込みプレーヤーを介して API クライアントに埋め込む前に、YouTube Data API サービスを使用してコンテンツのステータスを確認する必要があります。
新しい動画の子ども向けステータスを確認するガイドでは、YouTube Data API Service を使用して動画の子ども向けステータスを検索する方法について説明しています。
これらの変更に伴い、埋め込みプレーヤー パラメータのドキュメントに、自動再生を有効にすると、プレーヤーに対するユーザー操作なしで再生が開始され、再生データの収集と共有がページの読み込み時に行われることを説明する注意事項が追加されました。
2020 年 10 月 8 日
このアップデートでは、channel
リソースに関連する次の 3 つの軽微な変更が行われています。
- チャンネルのサムネイル画像を識別する
snippet.thumbnails
オブジェクトは、新しく作成されたチャンネルでは空になることがあります。また、入力されるまでに最大で 1 日かかることがあります。 statistics.videoCount
プロパティには、所有者も含め、チャンネルの公開動画の数のみが反映されます。この動作は、YouTube ウェブサイトに表示されるカウントと一致します。brandingSettings.channel.keywords
プロパティで識別されるチャネル キーワードは、許容される最大長の 500 文字を超えている場合や、エスケープされていない引用符("
)が含まれている場合、切り捨てられることがあります。500 文字の上限はキーワードごとの上限ではなく、すべてのキーワードの合計長の上限です。この動作は YouTube ウェブサイトの動作と一致しています。
2020 年 9 月 9 日
注: これは非推奨のお知らせです。
この更新には、次の API の変更が含まれます。すべての変更は、この発表日である 2020 年 9 月 9 日以降に適用されます。そのため、デベロッパーは、以下に記載されている API 機能に依存しないでください。
-
次の API リソース、メソッド、パラメータ、リソース プロパティは直ちに非推奨になり、この発表日以降は機能しなくなります。
- 次の
channel
リソース プロパティ:statistics.commentCount
プロパティbrandingSettings.image
オブジェクトとそのすべての子プロパティbrandingSettings.hints
リストとそのすべての子プロパティ
channels.list
メソッドのcategoryId
フィルタ パラメータguideCategories
リソースとguideCategories.list
メソッド
- 次の
-
API リクエストで
managedByMe
パラメータがtrue
に設定されている場合、channels.list
メソッドの API レスポンスにはprevPageToken
プロパティが含まれなくなりました。この変更は、他のchannels.list
リクエストのprevPageToken
プロパティには影響しません。また、リクエストのnextPageToken
プロパティにも影響しません。 -
channel
リソースのcontentDetails.relatedPlaylists.watchLater
プロパティとcontentDetails.relatedPlaylists.watchHistory
プロパティは、2016 年 8 月 11 日に非推奨として発表されました。これらの再生リストに対するplaylistItems.insert
メソッドとplaylistItems.delete
メソッドのサポートも完全に非推奨になり、2 つのプロパティはドキュメントから削除されました。 -
2013 年 7 月 30 日に非推奨として発表された
channels.list
メソッドのmySubscribers
パラメータはドキュメントから削除されました。subscriptions.list
メソッドとそのmySubscribers
パラメータを使用して、認証されたユーザーのチャンネルの登録者のリストを取得します。 -
channel
リソースのinvideoPromotion
オブジェクトとそのすべての子プロパティは、2017 年 11 月 27 日に非推奨として発表されました。これらのプロパティはドキュメントから削除されました。
2020 年 7 月 29 日
part
パラメータに関連付けられた追加費用を削除することで、API リクエストの割り当て課金プロセスを簡素化しました。直ちに適用されるため、呼び出されたメソッドの基本コストのみが請求されます。簡素化された割り当ての詳細については、こちらをご覧ください。
この変更の影響により、ほとんどの API 呼び出しの割り当て費用がわずかに低下しますが、一部の API 呼び出しの費用は変わりません。この変更によって API 呼び出しの費用が増加することはありません。全体的な影響としては、Google Cloud コンソールで確認できる割り当てられた割り当てが少し増える可能性があります。
YouTube API サービスへの継続的なアクセスを確保するため、すべてのデベロッパーはプロジェクトのコンプライアンス監査を完了することを強くおすすめします。
この変更履歴項目は 2020 年 7 月 20 日に公開されたものです。
2020 年 7 月 28 日
2020 年 7 月 28 日以降に作成された未確認の API プロジェクトから videos.insert
エンドポイント経由でアップロードされた動画はすべて、非公開の視聴モードに制限されます。この制限を解除するには、各プロジェクトで利用規約への準拠を確認する監査を受ける必要があります。
未確認の API クライアントを使用して動画をアップロードすると、動画が非公開としてロックされていることと、公式または監査済みのクライアントを使用することで制限を回避できることを説明するメールが届きます。
2020 年 7 月 28 日より前に作成された API プロジェクトは、現在、この変更の影響を受けません。ただし、YouTube API サービスへの継続的なアクセスを確保するため、すべてのデベロッパーはプロジェクトのコンプライアンス監査を完了することを強くおすすめします。
2020 年 7 月 21 日
[2020 年 7 月 28 日更新] この変更履歴エントリで参照されているドキュメントの更新は、2020 年 7 月 28 日に再公開されました。
昨日、割り当ての請求プロセスに関連するドキュメントの更新を公開しました。ただし、想定外の状況により、割り当ての変更はまだ有効になっていません。そのため、正確性を保つため、ドキュメントを元に戻しました。混乱を避けるため、変更内容を説明する変更履歴エントリは削除されました。このエントリは近日中に再公開されます。
2020 年 7 月 7 日
注: これは非推奨のお知らせです。
videos.insert
メソッドの autoLevels
パラメータと stabilize
パラメータは非推奨になり、両方のパラメータがドキュメントから削除されました。これらの値は無視され、新しくアップロードされた動画の処理方法には影響しません。
2020 年 6 月 15 日
新しい YouTube デベロッパー ポリシーに準拠するガイドでは、API クライアントが YouTube API サービスの利用規約とポリシー(API TOS)の特定の部分に準拠できるようにするためのガイダンスと例が示されています。
このガイダンスは、YouTube が API TOS の特定の側面をどのように適用するかについての説明であり、既存のドキュメントを置き換えるものではありません。このガイドでは、API コンプライアンス監査中にデベロッパーから寄せられるよくある質問の一部を取り上げています。このガイドが、Google によるポリシーの解釈と適用方法を理解し、機能開発プロセスを簡素化する一助となることを願っております。
2020 年 6 月 4 日
注: これは、前回のサポート終了に関するお知らせの更新版です。
チャンネル メッセージ機能のサポートが完全に終了しました。この変更は 2020 年 4 月 17 日に初めて発表されましたが、現在は適用されています。そのため、activities.insert
メソッドはサポートされなくなり、activities.list
メソッドはチャンネルのお知らせを返さなくなりました。詳しくは、YouTube ヘルプセンターをご覧ください。
2020 年 4 月 17 日
注: これはサポート終了のお知らせです。
YouTube はチャンネル メッセージ機能をサポート終了します。そのため、activities.insert
メソッドは非推奨となり、activities.list
メソッドはチャンネルのお知らせメッセージを返さなくなります。これらの変更は、2020 年 5 月 18 日以降に API に適用されます。詳しくは、YouTube ヘルプセンターをご覧ください。
2020 年 3 月 31 日
この改訂での変更内容は次のとおりです:
-
新しいリソースとメソッド
-
新しい
member
リソースは、YouTube チャンネルのチャンネル メンバーを表します。メンバーはクリエイターに定期的な金銭的支援を提供し、特別な特典を受け取ります。たとえば、クリエイターがチャットのメンバー限定モードをオンにすると、メンバーはチャットに参加できます。このリソースは、YouTube Live Streaming API の一部としてドキュメント化されている
sponsor
リソースに代わるものです。sponsor
リソースは非推奨になったため、API クライアントはsponsors.list
メソッドの呼び出しを更新して、代わりにmembers.list
メソッドを使用する必要があります。 -
新しい
membershipsLevel
リソースは、API リクエストを承認したクリエイターが管理する料金レベルを識別します。membershipsLevels.list
メソッドは、クリエイターのすべてのメンバーシップ レベルのリストを取得します。
-
2020 年 1 月 10 日
この API は、子ども向けコンテンツ(YouTube では「子ども向け」)を特定する機能をサポートするようになりました。「子ども向け」コンテンツについて詳しくは、YouTube ヘルプセンターをご覧ください。
channel
リソースと video
リソースは、コンテンツ作成者と視聴者が子ども向けコンテンツを識別できるように、次の 2 つの新しいプロパティをサポートしています。
-
selfDeclaredMadeForKids
プロパティを使用すると、コンテンツ クリエイターはチャンネルや動画が子ども向けかどうかを指定できます。
チャンネルの場合、このプロパティはchannels.update
メソッドを呼び出すときに設定できます。動画の場合は、videos.insert
メソッドまたはvideos.update
メソッドを呼び出すときにこのプロパティを設定できます。
このプロパティは、チャンネル所有者が API リクエストを承認した場合にのみ、channel
リソースまたはvideo
リソースを含む API レスポンスに含まれます。 -
madeForKids
プロパティを使用すると、どのユーザーでもチャンネルまたは動画の「子ども向け」ステータスを取得できます。たとえば、selfDeclaredMadeForKids
プロパティの値に基づいてステータスが決定されます。チャンネル、動画、ブロードキャストの視聴者を設定する方法について詳しくは、YouTube ヘルプセンターをご覧ください。
また、YouTube API サービスの利用規約とデベロッパー ポリシーも更新しました。詳しくは、YouTube API サービスの利用規約 - 変更履歴をご覧ください。YouTube API サービスの利用規約とデベロッパー ポリシーの変更は、2020 年 1 月 10 日(太平洋時間)に有効になります。
2019 年 9 月 10 日
API リファレンス ドキュメントが更新され、YouTube、ひいては API レスポンスでのチャンネル登録者数のレポート方法の変更が反映されました。この変更により、YouTube Data API サービスから返されるチャンネル登録者数は、登録者数が 1,000 人を超える場合、小数点以下 3 桁に切り捨てられます。この変更は、channel
リソースの statistics.subscriberCount プロパティに影響します。
注: この変更は、ユーザーが自分のチャンネルに関するデータに対する承認済みリクエストを送信した場合でも、このプロパティ値に影響します。チャンネル所有者は、引き続き YouTube Studio で正確なチャンネル登録者数を確認できます。
たとえば、チャンネル登録者数が 123,456 人の場合、statistics.subscriberCount
プロパティには値 123000
が含まれます。以下の表は、API レスポンスではチャンネル登録者数が四捨五入され、他の一般公開される YouTube ユーザー インターフェースで省略される方法の例を示しています。
チャンネル登録者数の例 | YouTube Data API | 一般公開されている YouTube UI |
---|---|---|
1,234 | 1230 | 1230 |
12,345 | 12300 | 1.23 万 |
123,456 | 123000 | 12.3万 |
1,234,567 | 1230000 | 123万 |
1,2345,678 | 12300000 | 1230万 |
123,456,789 | 123000000 | 123M |
2019 年 4 月 4 日
この改訂での変更内容は次のとおりです:
-
API リファレンス ドキュメントが更新され、各メソッドの一般的なユースケースがよりわかりやすく説明されるようになりました。また、API Explorer ウィジェットを通じて、高品質の動的コードサンプルが提供されるようになりました。例については、
channels.list
メソッドのドキュメントをご覧ください。API メソッドを説明するページに、2 つの新しい要素が追加されました。-
API Explorer ウィジェットを使用すると、認可スコープを選択して、サンプルのパラメータとプロパティの値を入力し、実際の API リクエストを送信して実際の API レスポンスを確認できます。このウィジェットでは、コードサンプルの全画面表示が全画面表示されます。コードサンプルは、入力したスコープと値を使用するように動的に更新されます。
-
[一般的なユースケース] セクションでは、このページで説明するメソッドの一般的なユースケースについて説明します。たとえば、
channels.list
メソッドを呼び出して、特定のチャンネルに関するデータや、現在のユーザーのチャンネルに関するデータを取得できます。このセクションのリンクを使用して、ユースケースのサンプル値を API Explorer に入力したり、それらの値がすでに入力されたフルスクリーンの API Explorer を開いたりできます。これらの変更は、独自のアプリに実装しようとしているユースケースに直接適用できるコードサンプルを簡単に確認できるようにすることを目的としています。
現在、コードサンプルは Java、JavaScript、PHP、Python、curl でサポートされています。
-
-
コードサンプルツールも更新され、上記と同じ機能をすべて備えた新しい UI が導入されました。このツールを使用すると、さまざまなメソッドのユースケースを調べたり、API Explorer に値を読み込んだり、API Explorer を全画面表示して Java、JavaScript、PHP、Python のコードサンプルを取得したりできます。
この変更に伴い、これまで Java、JavaScript、PHP、Python の利用可能なコードサンプルを掲載していたページは削除されました。
-
Java、JavaScript、PHP、Python のクイックスタート ガイドが更新されました。改訂版のガイドでは、API キーと OAuth 2.0 クライアント ID を使用するサンプルを、API Explorer のコードサンプルを使用して実行する方法について説明しています。
なお、上記の変更は、2017 年に API ドキュメントに追加されたインタラクティブ ツールに代わるものです。
2018 年 7 月 9 日
この改訂での変更内容は次のとおりです:
-
channel
リソースのsnippet.thumbnails
プロパティの定義が更新され、アプリケーションでサムネイルを表示する際に、API レスポンスで返される画像 URL をコードで使用する必要があることが示されています。たとえば、アプリケーションでは、API レスポンスで返される URL でhttps
ドメインの代わりにhttp
ドメインを使用しないでください。2018 年 7 月より、チャンネル サムネイルの URL は
https
ドメインでのみ使用できるようになります。この URL は、API レスポンスに表示される URL です。この期間を過ぎると、http
ドメインから YouTube 画像を読み込もうとすると、アプリケーションに破損した画像が表示されることがあります。 -
注: これは非推奨のお知らせです。
video
リソースのrecordingDetails.location.altitude
プロパティは非推奨になりました。動画がこのプロパティの値を返す保証はありません。同様に、API リクエストでそのプロパティに値を設定しようとしても、受信データは保存されません。
2018 年 6 月 22 日
実装ガイド(旧称: 実装と移行ガイド)が更新され、v2 API から v3 API への移行手順が削除されました。また、お気に入りの動画など、v3 API でサポートが終了した機能の手順も削除しました。
2017 年 11 月 27 日
この改訂での変更内容は次のとおりです:
-
注: これはサポート終了のお知らせです。
YouTube は、
channel
リソースのinvideoPromotion
オブジェクトを介して API でサポートされている注目動画機能と注目ウェブサイト機能のサポートを終了します。そのため、このオブジェクト(そのすべての子プロパティを含む)のサポートは終了します。invideoPromotion
データの取得と設定は 2017 年 12 月 14 日まで可能です。この日以降は、次のようになります。channels.list
を呼び出したときにinvideoPromotion
の部分を取得しようとすると、空のinvideoPromotion
が返されるか、invideoPromotion
データはまったく返されません。channels.update
の呼び出し時にinvideoPromotion
データを更新しようとすると、少なくとも 2018 年 5 月 27 日までは成功のレスポンスが返されますが、NoOps として扱われ、実際には更新は行われません。
2018 年 5 月 27 日以降は、これらのリクエストから、たとえば
invalidPromotion
が無効な部分であることを示すエラー メッセージが返される可能性があります。
2017 年 11 月 16 日
この改訂での変更内容は次のとおりです:
-
インタラクティブなコードスニペット ツールが Node.js コードサンプルをサポートするようになりました。サンプルは、
channels.list
メソッドなど、ほぼすべての API メソッドのドキュメントにも表示されます。これらのカスタマイズ可能なサンプルは、Node.js アプリケーションのユースケース固有の出発点として使用できるように設計されています。機能は、Node.js クイックスタート ガイドのコードと似ています。ただし、サンプルには、このクイックスタートには表示されないユーティリティ関数が含まれています。
removeEmptyParameters
関数は、API リクエスト パラメータに対応する Key-Value ペアのリストを受け取り、値のないパラメータを削除します。createResource
関数は、API リソースのプロパティに対応する Key-Value ペアのリストを受け取ります。次に、プロパティをinsert
オペレーションとupdate
オペレーションで使用できる JSON オブジェクトに変換します。次の例は、プロパティ名と値のセトと、コードがそれらに対して作成する JSON オブジェクトを示しています。# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }
これらのサンプルはすべて、ローカルにダウンロードして実行するように設計されています。詳細については、コード スニペット ツールの手順で、完全なコードサンプルをローカルで実行するための前提条件をご覧ください。
2017 年 10 月 25 日
この改訂での変更内容は次のとおりです:
-
インタラクティブなコード スニペット ツールの Python コードサンプルが、サポートが終了した
oauth2client
ライブラリの代わりにgoogle-auth
ライブラリとgoogle-auth-oauthlib
ライブラリを使用するように更新されました。この変更に加え、インストール済みの Python アプリケーションと Python ウェブサーバー アプリケーションの完全なコードサンプルも提供されるようになりました。これらのアプリケーションでは、少し異なる認証フローが使用されています。すべてのサンプル(およびこの変更)を表示するには:
- インタラクティブなコード スニペット ツールまたは
channels.list
メソッドなどの API メソッドのドキュメントをご覧ください。 - コードサンプルの上にある
Python
タブをクリックします。 - タブの上にある切り替えボタンをクリックすると、スニペットから完全なサンプルに切り替えることができます。
- タブに、
InstalledAppFlow
認可フローを利用する完全なコードサンプルが表示されます。サンプルの上の説明に、この点について説明があり、ウェブサーバー アプリケーションのサンプルへのリンクもあります。 - リンクをクリックしてウェブサーバーの例に切り替えます。このサンプルでは、Flask ウェブ アプリケーション フレームワークと別の認可フローを使用しています。
これらのサンプルはすべて、ローカルにダウンロードして実行するように設計されています。サンプルを実行する場合は、コード スニペット ツールの手順のコードサンプルをローカルで実行するの手順をご覧ください。
- インタラクティブなコード スニペット ツールまたは
2017 年 8 月 29 日
この改訂での変更内容は次のとおりです:
search.list
メソッドのforContentOwner
パラメータの定義が更新され、パラメータがtrue
に設定されている場合は、type
パラメータをvideo
に設定する必要があります。search.list
メソッドのregionCode
パラメータの定義が更新され、このパラメータでは検索結果が指定した地域で視聴可能な動画に限定されていることが明記されました。- YouTube のブランドロゴとアイコンが新しくなりました。新しい「YouTube で開発」ロゴは、ブランドの取り扱いガイドラインのページからダウンロードできます。このページには、他の新しい YouTube のロゴとアイコンも表示され、YouTube ブランドサイトからダウンロードできます。
2017 年 7 月 24 日
この改訂での変更内容は次のとおりです:
- iOS 向けの新しい YouTube Data API クイックスタート ガイドをご利用いただけます。このガイドでは、Objective-C または Swift で記述されたシンプルな iOS アプリケーションで YouTube Data API を使用する方法について説明します。
- YouTube Data API のインタラクティブなコード スニペット ツールに、ツールの機能を説明するドキュメントが追加されました。
- API リクエストの実行
- コードスニペットと完全なコードサンプルの切り替え
- ボイラープレート関数の使用
- 既存のリソースの読み込み(更新メソッドの場合)
注: このツールは、API メソッドの API リファレンス ドキュメント(例)にも埋め込まれています。
2017 年 6 月 1 日
この改訂での変更内容は次のとおりです:
-
注: これはサポート終了のお知らせです。
次の
video
リソース プロパティは非推奨になります。これらのプロパティは 2017 年 12 月 1 日までサポートされますが、それまで動画でこれらのプロパティの値が返されるとは限りません。同様に、これらのプロパティ値を設定するvideos.insert
リクエストとvideos.update
リクエストで、この日より前にエラーが発生しることはありませんが、受信データが保存されない可能性があります。
2017 年 5 月 17 日
この改訂での変更内容は次のとおりです:
-
API リファレンス ドキュメントが更新され、コード スニペットがよりユビキタスでインタラクティブになりました。
channels.list
やvideos.rate
などの API メソッドについて説明するページに、Java、JavaScript、PHP、Python、Ruby、Apps Script、Go のコード スニペットを表示してカスタマイズできるインタラクティブなツールが追加されました。ツールには、どのメソッドについても 1 つ以上のユースケースのコード スニペットが表示され、各ユースケースではそのメソッドを呼び出す一般的な方法が示されます。たとえば、
channels.list
メソッドを呼び出して、特定のチャンネルまたは現在のユーザーのチャンネルに関するデータを取得できます。コードサンプルを操作することもできます。
-
パラメータとプロパティの値を変更すると、指定した値を反映してコード スニペットが動的に更新されます。
-
コード スニペットと完全なサンプルを切り替えます。コード スニペットは、API メソッドを呼び出すコードの部分を示しています。完全なサンプルには、このスニペットと、リクエストを承認および送信するためのボイラープレート コードが含まれています。完全なサンプルは、コマンドラインまたはローカル ウェブサーバーからコピーして実行できます。
-
ボタンをクリックしてリクエストを実行します。(リクエストを実行するには、ユーザーに代わって API を呼び出すようにツールを承認する必要があります)。
このツールは、利用可能なページで API Explorer に代わるものです。(各ページにリンクが表示されるため、作業中のリクエストを API Explorer に読み込むこともできます)。
-
-
Data API コード スニペット ツールも更新され、前述の機能をすべて備えた新しい UI が導入されました。このページで利用できる主な新機能は次のとおりです。
- データを書き込む API リクエストのサポート。
- Java サンプルのサポート。
- ユーザーの認証と API リクエストの作成に使用する、より柔軟で包括的なボイラープレート コード。
2017 年 4 月 27 日
この改訂での変更内容は次のとおりです:
- 新しいクイックスタート ガイドでは、YouTube Data API リクエストを行うシンプルなアプリケーションを設定する方法を説明しています。現在、ガイドは Android、Apps Script、Go、Java、JavaScript、Node.js、PHP、Python、Ruby でご利用いただけます。
2017 年 3 月 30 日
この改訂での変更内容は次のとおりです:
channel
リソースの新しいtopicDetails.topicCategories[]
プロパティには、チャンネルのコンテンツを記述する Wikipedia URL のリストが含まれています。この URL は、リソースのtopicDetails.topicIds[]
プロパティで返されるトピック ID に対応しています。playlistItem
リソースの新しいcontentDetails.videoPublishedAt
プロパティは、動画が YouTube に公開された時刻を示します。このリソースには、アイテムが再生リストに追加された時刻を識別するsnippet.publishedAt
プロパティがすでに含まれています。channel
リソースと同様に、video
リソースはtopicDetails.topicCategories[]
プロパティを返すようになりました。このプロパティには、動画のコンテンツを説明する Wikipedia URL のリストが含まれています。video
リソースの場合、URL はリソースのtopicDetails.relevantTopicIds[]
プロパティで返されるトピック ID に対応しています。video
リソースの新しいcontentDetails.contentRating.mpaatRating
プロパティは、アメリカ映画協会が映画の予告編やプレビューに付けた評価を識別します。
2017 年 2 月 27 日
2016 年 8 月 11 日にお知らせしたとおり、YouTube はトピック ID でサポートされているリストをキュレートされたリストに切り替えました。サポートされているトピック ID の完全なリストは、channel
リソースと video
リソースの topicDetails
プロパティと、search.list
メソッドの topicId
パラメータに含まれています。
キュレート済みリストには、次のような変更があります。
- 次のトピックが
Society
のサブトピックとして追加されました。名前 トピック ID ビジネス /m/09s1f
健康 /m/0kt51
軍事 /m/01h6rj
政治 /m/05qt0
宗教 /m/06bvp
- 以前は
Entertainment
の子だったAnimated cartoon
トピックは削除されました。 - 以前は
Music
の子だったChildren's music
トピックは削除されました。
この変更により、動画に関連するトピックは常に video
リソースの topicDetails.relevantTopicIds[]
プロパティ値で返されるようになりました。
2016 年 11 月 29 日
この改訂での変更内容は次のとおりです:
-
2017 年 2 月 10 日より、トピック ID のリストに次の 3 つの軽微な変更が加えられます。
- 以前は
Sports
カテゴリの子でしたが、Professional wrestling
カテゴリがEntertainment
の子になりました。 Entertainment
の子であるTV shows
カテゴリが新規に追加されました。Lifestyle
の子カテゴリだったHealth
カテゴリが削除されました。
また、親カテゴリがいくつかあります(
Entertainment
、Gaming
、Lifestyle
、Music
、Sports
)。子カテゴリ(Tennis
など)に関連付けられた動画は、親カテゴリ(Sports
)にも関連付けられます。 - 以前は
2016 年 11 月 10 日
この改訂での変更内容は次のとおりです:
-
2016 年 8 月 11 日に最初にお知らせしたとおり、Freebase と Freebase API の非推奨化に伴い、トピック ID に関連するいくつかの変更が必要になります。トピック ID は、
channel
リソースとvideo
リソースに関連付けられたトピックを識別します。また、topicId
検索パラメータを使用して、特定のトピックに関連するチャンネルまたは動画を検索することもできます。2017 年 2 月 10 日より、これまで返されていたよりきめ細かい ID セットではなく、トピック ID の小さなセットが返されるようになります。また、チャンネルと動画がトピックに関連付けられているとは限りません。これは現在の API の動作と一貫しています。
これらの変更に備えて API クライアントを準備できるように、次の API パラメータとプロパティの定義が更新され、それ以降サポートされるトピック ID がリストに追加されました。カテゴリのリストはすべてのプロパティで同じです。
channel
リソースのtopicDetails.topicIds[]
プロパティ。video
リソースのtopicDetails.relevantTopicIds[]
プロパティ。search.list
メソッドのtopicId
パラメータ。
-
注: これは非推奨のお知らせです。
次のプロパティは非推奨になります。
channel
リソースのtopicDetails.topicIds[]
プロパティ。このプロパティは 2017 年 11 月 10 日までサポートされます。video
リソースのtopicDetails.relevantTopicIds[]
プロパティ。このプロパティは 2017 年 11 月 10 日までサポートされます。video
リソースのtopicDetails.topicIds[]
プロパティ。このプロパティには、2017 年 2 月 10 日以降の値は含まれません。(この日以降は、動画に関連付けられているすべてのトピックがtopicDetails.relevantTopicIds[]
プロパティ値で識別されるようになります)。
-
Freebase はすでにサポートが終了しているため、ドキュメントから Freebase Topics を使用した検索ガイドを削除しました。このガイドでは、アプリケーションが Freebase API と連携する様子を示すコードサンプルを提供していました。
さらに、
search.list
メソッドのドキュメントからトピック ID に関連するいくつかのコードサンプルが削除されています。
2016 年 11 月 2 日
この改訂での変更内容は次のとおりです:
-
新しいプロパティとパラメータ
-
video
リソースには、次のような新しいプロパティが含まれています。-
player.embedHtml
プロパティには、動画を再生するプレーヤーを埋め込むために使用できる<iframe>
タグが含まれます。新しいplayer.embedHeight
プロパティとplayer.embedWidth
プロパティは、埋め込みプレーヤーのサイズを指定します。これらのプロパティは、API リクエストでmaxHeight
パラメータまたはmaxWidth
パラメータの少なくとも 1 つに値が指定されている場合にのみ返されます。この 2 つの新しいパラメータについては、この変更履歴エントリの後半で説明します。 -
新しい
hasCustomThumbnail
プロパティは、動画のアップロードしたユーザーが動画にカスタム サムネイル画像を提供したかどうかを示します。このプロパティは動画をアップロードしたユーザーにのみ表示されます。 -
新しい
fpbRatingReasons[]
は、動画が FPB(南アフリカ)評価を受けた理由を示します。 -
新しい
mcstRating
は、ベトナムで動画に付与されたレーティングを識別します。
-
-
videos.list
メソッドは、maxHeight
とmaxWidth
の 2 つの新しいパラメータをサポートします。video
リソースのplayer
部分を取得する場合は、どちらか一方のパラメータまたは両方のパラメータを使用できます。デフォルトでは、
player.embedHtml
プロパティで返される<iframe>
の高さは 360 ピクセルです。幅は動画のアスペクト比に合わせて調整されるため、埋め込みプレーヤーに動画の周囲に黒い帯が表示されることはありません。たとえば、動画のアスペクト比が 16:9 の場合、プレーヤーの幅は 640 ピクセルになります。新しいパラメータを使用すると、デフォルトのサイズではなく、アプリのレイアウトに適した高さや幅を埋め込みコードで使用するよう指定できます。API サーバーは、埋め込みプレーヤーに動画のフレームとして黒いバーが表示されないように、必要に応じてプレーヤーのサイズをスケーリングします。どちらのパラメータも、埋め込みプレーヤーの最大サイズを指定します。したがって、両方のパラメータを指定した場合でも、1 つのディメンションがそのディメンションで許可される最大量よりも小さい場合があります。
たとえば、アスペクト比が 16:9 の動画について考えてみましょう。したがって、
maxHeight
パラメータまたはmaxWidth
パラメータが設定されていない場合、player.embedHtml
タグには 640x360 のプレーヤーが含まれます。maxHeight
パラメータが720
に設定され、maxWidth
パラメータが設定されていない場合、API は 1280x720 のプレーヤーを返します。maxWidth
パラメータが960
に設定され、maxHeight
パラメータが設定されていない場合、API は 960x540 のプレーヤーを返します。maxWidth
パラメータが960
に設定され、maxHeight
パラメータが450
に設定されている場合、API は 800x450 のプレーヤーを返します。
上記の新しい
player.embedHeight
プロパティとplayer.embedWidth
プロパティは、プレーヤーのサイズを識別します。
-
-
既存のメソッド、プロパティ、パラメータの更新
-
channelSection
リソースの説明を更新し、1 つのチャンネルはターゲティング データを設定しなくても最大 10 個のセクションを作成できることと、ターゲティング データを持つセクションを最大 100 個作成できることを記載しました。また、ターゲティング オプションは API を使用してのみ設定できることを反映するため、
channelSection
リソースのtargeting
プロパティが更新されました。YouTube ウェブサイトのユーザー インターフェースを使用してチャンネル セクションを変更すると、ターゲティング オプションは削除されます。 -
i18nLanguage
リソースのsnippet.name
プロパティの定義を修正し、値がi18nLanguage.list
メソッドのhl
パラメータで指定された言語で記述された言語名を表すことを反映しました。 -
playlistItem
リソースのcontentDetails.note
プロパティが更新され、プロパティ値の最大長が 280 文字であることが明記されました。 -
playlistItem
リソースのcontentDetails.startAt
プロパティとcontentDetails.endAt
プロパティは非推奨になりました。これらのフィールドがplaylistItems.insert
リクエストまたはplaylistItems.update
リクエストで設定されている場合、これらのフィールドは無視されます。 -
playlistItems.delete
メソッドとplaylistItems.update
メソッドでonBehalfOfContentOwner
パラメータがサポートされるようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。このメソッドを使用するリクエストは、https://www.googleapis.com/auth/youtubepartner
スコープへのアクセス権を提供するトークンによって承認される必要があります。 -
search.list
メソッドのpublishedBefore
パラメータとpublishedAfter
パラメータの両方が更新され、パラメータ値が包括的であることを示すように変更されました。たとえば、publishedBefore
パラメータが設定されている場合、API は指定された時刻の前またはその時刻に作成されたリソースを返します。 -
video
リソースのcontentDetails.contentRating.grfilmRating
プロパティは、grfilmK12
、grfilmK15
、grfilmK18
の 3 つの追加値をサポートします。 -
videos.insert
メソッドの説明が更新され、アップロードされる動画の最大サイズが 64 GB から 128 GB に引き上げられました。
-
-
新しいエラーと更新されたエラー
-
API では、次の新しいエラーがサポートされています。
エラーのタイプ エラーの詳細 説明 forbidden (403)
homeParameterDeprecated
activities.list
メソッドはこのエラーを返し、ユーザーのホームページのアクティビティ データをこの API で使用できないことを示します。このエラーは、未承認のリクエストでhome
パラメータをtrue
に設定した場合に発生することがあります。invalidValue (400)
invalidContentDetails
playlistItems.insert
メソッドは、リクエスト内のcontentDetails
オブジェクトが無効であることを示すために、このエラーを返します。このエラーが発生する理由の一つは、contentDetails.note
フィールドが 280 文字を超えていることです。forbidden (403)
watchHistoryNotAccessible
playlistItems.list
メソッドはこのエラーを返し、リクエストで「再生履歴」の再生リスト アイテムを取得しようとしたものの、API では取得できなかったことを示します。forbidden (403)
watchLaterNotAccessible
playlistItems.list
メソッドは、リクエストで「後で見る」再生リストのアイテムを取得しようとしたが、API を使用して取得できないことを示すエラーを返します。badRequest (400)
uploadLimitExceeded
videos.insert
メソッドはこのエラーを返し、チャンネルでアップロードできる動画の数が超過したことを示します。forbidden (403)
forbiddenEmbedSetting
videos.update
メソッドは、API リクエストが動画に無効な埋め込み設定を設定しようとしていることを示すために、このエラーを返します。一部のチャンネルでは、ライブ配信の埋め込みプレーヤーを提供するための権限がない場合があります。詳しくは、YouTube ヘルプセンターをご覧ください。 -
重複する動画をプレイリストに挿入しても、
playlistItems.insert
メソッドがエラーを返さなくなりました。このエラーは以前、お気に入りの動画など、重複が許可されていない一部の再生リストで発生していましたが、それらの再生リストはサポートされなくなりました。一般に、再生リストでは動画の重複が許容されます。
-
-
その他の最新情報
-
2016 年 9 月 15 日の変更履歴エントリが更新され、
channel
リソースのcontentDetails.relatedPlaylists.watchHistory
プロパティとcontentDetails.relatedPlaylists.watchLater
プロパティがレスポンスに含まれている場合、常に値HL
とWL
が含まれることが明記されました。また、これらのプロパティは、承認済みユーザーが自身のチャンネルに関するデータを取得している場合にのみ含まれます。
-
2016 年 9 月 15 日
この改訂での変更内容は次のとおりです:
-
2016 年 8 月 11 日の変更履歴の更新では、サポートされるトピック ID のセットが 2017 年 2 月 10 日以降に変更されるという事実など、トピック ID に関連するいくつかの変更点が説明されました。サポートされるトピックの一覧は、2016 年 11 月 10 日までに公開されます。
-
現在、以下の変更が適用されています。これらの変更に関するお知らせは、2016 年 8 月 11 日の改訂履歴の更新で行われました。
-
home
パラメータをtrue
に設定してactivities.list
メソッドを呼び出した場合、API レスポンスには、ログアウトした YouTube ユーザーに対してホームページに表示されるものと同様のアイテムが含まれるようになりました。これは、2016 年 8 月 11 日のリビジョン履歴の更新で説明されている動作よりも優れたユーザー エクスペリエンスを提供することを目的とした、わずかな変更です。その更新では、
home
パラメータを使用するリクエストで空のリストが返されると記載されていました。 -
channel
リソースのcontentDetails.relatedPlaylists.watchHistory
プロパティとcontentDetails.relatedPlaylists.watchLater
プロパティに、すべてのチャンネルでそれぞれHL
とWL
の値が含まれるようになりました。なお、これらのプロパティは、ユーザー自身のチャンネルに関するデータを取得する承認済みユーザーにのみ表示されます。承認済みユーザーが自身のチャンネルに関するデータを取得する場合でも、プロパティには常に
HL
とWL
という値が含まれます。そのため、API では再生履歴や後で見る再生リストの ID を取得できません。また、チャンネルの再生履歴または [後で見る] 再生リストの再生リストの詳細(
playlists.list
)または再生リストのアイテム(playlistItems.list
)を取得するリクエストは、空のリストが返されるようになりました。この動作は、新しい値HL
とWL
だけでなく、API クライアントがすでに保存している視聴履歴や後で見る再生リスト ID にも適用されます。
-
-
video
リソースのfileDetails.recordingLocation
オブジェクトとその子プロパティが返されなくなりました。これまで、このデータ(親のfileDetails
オブジェクトなど)は、動画のオーナーのみが取得できました。
2016 年 8 月 11 日
この改訂での変更内容は次のとおりです:
-
新たに公開された YouTube API サービス利用規約(以下「更新後の利用規約」)は、YouTube エンジニアリングとデベロッパー ブログで詳しく説明されており、現在の利用規約にさまざまな更新が含まれています。2017 年 2 月 10 日に発効する利用規約の改定に加えて、デベロッパーが遵守すべきポリシーを説明する補足ドキュメントがいくつか追加されています。
新しいドキュメントの一覧は、更新版規約の変更履歴でご確認いただけます。また、本規約または補足文書に対する今後の変更についても、その変更履歴において説明されます。ドキュメント内のリンクから、その変更履歴の変更を示す RSS フィードを購読できます。
-
Freebase と Freebase API のサポート終了に伴い、トピック ID に関連する変更がいくつか発生します。トピック ID は、次の API リソースとメソッドで使用されます。
channel
リソースのtopicDetails
部分は、チャンネルに関連付けられているトピックを識別します。video
リソースのtopicDetails
部分は、動画に関連するトピックを識別します。search.list
メソッドのtopicId
パラメータを使用すると、特定のトピックに関連する動画やチャンネルを検索できます。
これらの機能の変更は次のとおりです。
-
2017 年 2 月 10 日より、これまで返されていたよりきめ細かい ID セットではなく、トピック ID の小さなセットが返されるようになります。スポーツやバスケットボールなどの大まかな分類は特定できますが、特定のチームや選手は特定されません。この変更に備えて申請の準備に時間をかけられるように、サポート対象のトピックを発表する予定です。
-
すでに取得した Freebase トピック ID は、2017 年 2 月 10 日までコンテンツの検索に使用できます。ただし、この期間を過ぎると、前のアイテムで特定した少数のトピックのみを使用して、トピック別の検索結果を取得できます。
-
2017 年 2 月 10 日以降、サポートされているトピック ID のうち少ないトピック ID を使用して検索結果を検索しようとすると、API から空の結果セットが返されます。
-
以下の API フィールドとパラメータは、2016 年 9 月 12 日をもってサポート終了となります。
-
activities.list
メソッドのhome
パラメータにより、承認済みユーザーは、そのユーザーの YouTube ホームページに表示されるアクティビティ フィードを取得できました。2016 年 9 月 12 日以降にこのパラメータを使用するリクエストは、空のリストが返されます。 -
channel
リソースのcontentDetails.relatedPlaylists.watchHistory
プロパティとcontentDetails.relatedPlaylists.watchLater
プロパティは、自身のチャンネルに関するデータを取得する承認済みユーザーにのみ表示されます。2016 年 9 月 12 日以降、すべてのチャネルについて、contentDetails.relatedPlaylists.watchHistory
はHL
の値を返し、contentDetails.relatedPlaylists.watchLater
プロパティはWL
の値を返します。チャンネルの再生履歴または後で見る再生リストの再生リストの詳細(
playlists.list
)を取得するリクエストは、2016 年 9 月 12 日以降、空のリストが返されます。これらのいずれかの再生リスト内の再生リスト アイテム(playlistItems.list
)を取得するリクエストも、この時間以降は空のリストが返されます。これは、新しい値のHL
とWL
のほか、API クライアントがすでに保存した再生履歴や後で見る再生リストの ID にも当てはまります。 -
video
リソースのfileDetails.recordingLocation
オブジェクトまたはその子プロパティは、2016 年 9 月 12 日以降は返されなくなります。親fileDetails
オブジェクトを取得できるのは動画の所有者のみであるため、このデータを取得できるのは動画の所有者のみです。
-
2016 年 6 月 13 日
この改訂での変更内容は次のとおりです:
-
channel
リソースのcontentDetails.googlePlusUserId
プロパティが非推奨になりました。これまでは、チャンネルが Google+ プロフィールに関連付けられている場合にのみ、プロパティが存在していました。サポート終了以降、このプロパティはどのchannel
リソースにも含まれなくなります。 -
comment
リソースのsnippet.authorGoogleplusProfileUrl
プロパティが非推奨になりました。これまで、このプロパティはチャンネルが Google+ プロフィールに関連付けられている場合にのみ存在していました。非推奨になると、このプロパティはどのcomment
リソースにも含まれなくなります。
非推奨化後はどちらのプロパティも返されなくなるため、両方のプロパティは対応するリソースのドキュメントから削除されました。
2016 年 5 月 31 日
この改訂での変更内容は次のとおりです:
-
subscriptions.list
メソッドの新しいmyRecentSubscribers
パラメータは、認証されたユーザーのチャンネルのチャンネル登録者のリストを、チャンネル登録した日時が新しい順に取得します。新しいパラメータで取得できるのは、認証されたユーザーの最新のチャンネル登録者数 1,000 人のみです。サブスクライバーの完全なリストを取得するには、
mySubscribers
パラメータを使用します。このパラメータは、サブスクライバーを特定の順序で返すわけではなく、取得できるサブスクライバーの数に制限はありません。 -
snippet.thumbnails.(key)
プロパティの定義が、activity、playlistItem、playlist、search result、thumbnail、video リソースで更新され、一部の動画で追加のサムネイル画像サイズが使用可能であることが明記されました。standard
の画像は幅 640 ピクセル、高さ 480 ピクセルです。maxres
の画像は幅 1,280 ピクセル、高さ 720 ピクセルです。
-
channelSection.list
メソッドのpart
パラメータの定義が更新され、2
割り当てユニットの費用でtargeting
部分を取得できることを記載しました。 -
適切に承認されていないリクエストが
video
リソースのfileDetails
、processingDetails
、またはsuggestions
部分を取得しようとすると、videos.list
メソッドがforbidden(403
)エラーを返すようになりました。これらの部分を利用できるのは、動画の所有者のみです。
2016 年 5 月 17 日
新しい Data API コード スニペット ツールには、YouTube Data API の一般的なユースケース向けの短いコード スニペットが用意されています。現在、コード スニペットは、Apps Script、Go、JavaScript、PHP、Python、Ruby のすべての読み取り専用 API メソッドで使用できます。
ツールには、メソッドごとに 1 つ以上のユースケースのコードサンプルが表示されます。たとえば、search.list
メソッド用に 5 つのコード スニペットがあります。
- キーワードで動画を一覧表示する
- 場所別に動画を一覧表示する
- ライブイベントを一覧表示する
- 認証されたユーザーの動画を検索する
- 関連動画を表示する
このツールはユースケースごとに、API リクエストで使用されているパラメータを表示します。パラメータ値を変更できます。この場合、ツールは指定したパラメータ値を反映するようにコード スニペットを更新します。
最後に、各リクエストに対する API レスポンスがツールに表示されます。リクエスト パラメータを変更した場合、API レスポンスは指定したパラメータ値に基づきます。API レスポンスを表示するには、ユーザーに代わってリクエストを送信するようツールを承認する必要があります。
2016 年 4 月 28 日
この改訂での変更内容は次のとおりです:
-
video
リソースの新しいcontentDetails.projection
プロパティは、動画のプロジェクション形式を指定します。有効なプロパティ値は360
とrectangular
です。 -
video
リソースのrecordingDetails.location
プロパティとfileDetails.recordingLocation
プロパティの両方が更新され、2 つのプロパティの違いが説明されました。recordingDetails.location
プロパティは、動画の所有者が動画に関連付ける場所を識別します。この場所は編集可能で、公開動画では検索可能です。公開動画ではユーザーに表示される場合があります。fileDetails.recordingLocation
プロパティ値は不変で、アップロードされた元の動画ファイルに関連付けられたロケーションを表します。この値は動画の所有者のみが確認できます。
-
channel
リソースのcontentDetails.relatedPlaylists.favorites
プロパティの定義が更新され、プロパティ値には空の再生リストを参照する再生リスト ID が含まれており、その再生リスト ID は取得できない可能性があることがわかりました。これは、お気に入りの動画機能のサポートがすでに終了しているためです。このプロパティは、API 非推奨ポリシーの対象外です。 -
comments.insert
、comments.update
、commentThreads.insert
、commentThreads.update
メソッドによって返されるineligibleAccount
エラーの定義が更新され、API リクエストの承認に使用された YouTube アカウントがユーザーの Google アカウントと統合されていない場合にエラーが発生することが反映されました。
2016 年 4 月 20 日
この改訂での変更内容は次のとおりです:
-
channels.update
メソッドのpart
パラメータの定義を更新し、localizations
もそのパラメータの有効な値であることを明記しました。 -
スタートガイドの「割り当ての使用状況」セクションが更新され、Google Developers Console にリンクしました。このコンソールで、実際の割り当てと割り当ての使用状況を確認できます。
2016 年 3 月 16 日
この改訂での変更内容は次のとおりです:
-
既存のリソースとメソッドの更新
-
channelBanner
リソースのドキュメントが更新され、アップロードされたチャンネル バナー画像の推奨サイズが 2560px x 1440px であることが記載されています。最小サイズ(2,048 x 1,152 ピクセル)は変更されていません。 -
channel
リソースの新しいsnippet.customUrl
プロパティは、チャンネルに関連付けられたカスタム URL を識別します。(すべてのチャンネルにカスタム URL があるわけではありません)。YouTube ヘルプセンターでは、カスタム URL の利用資格要件と URL の設定方法について説明しています。 -
channel
リソースのbrandingSettings.watch
オブジェクトとそのすべての子プロパティは非推奨になりました。 -
search.list
リクエストに対する API レスポンスにregionCode
プロパティが追加されました。このプロパティは、検索クエリに使用された地域コードを示します。地域コードは、指定した国の検索結果を返すように API に指示します。プロパティの値は、地域を識別する 2 文字の ISO 国コードです。
i18nRegions.list
メソッドは、サポートされているリージョンのリストを返します。デフォルト値はUS
です。サポートされていないリージョンが指定されている場合でも、YouTube はデフォルト値ではなく別のリージョンを選択してクエリを処理することがあります。 -
videoAbuseReportReason
リソースのsnippet.label
プロパティとsnippet.secondaryReasons[].label
プロパティの定義が更新され、これらのプロパティに不正行為報告の理由のローカライズ済みラベルテキストが含まれていることが明記されました。さらに、
videoAbuseReportReasons.list
メソッドでhl
パラメータがサポートされるようになりました。このパラメータは、API レスポンスのラベルテキストに使用する言語を指定します。デフォルトのパラメータ値はen_US
です。 -
video
リソースの新しいcontentDetails.contentRating.ecbmctRating
プロパティは、トルコの文化観光省評価分類委員会による動画のレーティングを識別します。また、他のレーティング システムの API プロパティは、次の新しいプロパティ値をサポートしています。
contentDetails.contentRating.fpbRating
(南アフリカ)
評価: 10; プロパティ値:fpb10
contentDetails.contentRating.moctwRating
(台湾)
レーティング: R-12、プロパティ値:moctwR12
contentDetails.contentRating.moctwRating
(台湾)
評価: R-15; プロパティ値:moctwR15
-
video
リソースのliveStreamingDetails.activeLiveChatId
プロパティには、動画に関連付けられているアクティブなチャットの ID が含まれます。このプロパティ値は、ライブ配信が有効になっている現在のライブ配信の動画にのみ存在します。配信とチャットが終了すると、その動画のプロパティは返されなくなります。 -
video
リソースのstatus.rejectionReason
プロパティは、新しいプロパティ値legal
をサポートしています。
-
-
API では、次の新しいエラーがサポートされています。
エラーのタイプ エラーの詳細 説明 badRequest (400)
notEditable
channelSections.insert
、channelSections.update
、channelSections.delete
メソッドは、指定されたチャンネル セクションを作成、更新、削除できないことを示すためにこのエラーを返します。badRequest (400)
styleRequired
channelSections.insert
メソッドとchannelSections.update
メソッドは、API リクエストで送信されたchannelSection
リソースでsnippet.style
プロパティの値を指定する必要があることを示す、このエラーを返します。badRequest (400)
typeRequired
channelSections.insert
メソッドとchannelSections.update
メソッドは、API リクエストで送信されたchannelSection
リソースでsnippet.type
プロパティの値を指定する必要があることを示す、このエラーを返します。badRequest (400)
processingFailure
commentThreads.list
メソッドは、API サーバーがリクエストを正常に処理できなかったことを示すために、このエラーを返します。これは一時的なエラーである可能性がありますが、通常はリクエストの入力が無効であることを示しています。リクエスト本文のcommentThread
リソースの構造が有効であることを確認します。forbidden (403)
commentsDisabled
commentThreads.list
メソッドは、videoId
パラメータで識別された動画でコメントが無効になっていることを示すために、このエラーを返します。badRequest (400)
commentTextTooLong
commentThreads.insert
メソッドは、挿入されているcomment
リソースのsnippet.topLevelComment.snippet.textOriginal
プロパティに含まれる文字が多すぎることを示すために、このエラーを返します。invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
playlistItems.insert
メソッドは、再生リストに追加しようとしている動画がすでに別のシリーズリストに含まれていることを示すために、このエラーを返します。シリーズの再生リストについて詳しくは、YouTube ヘルプセンターをご覧ください。badRequest (400)
subscriptionForbidden
subscriptions.insert
メソッドは、定期購入の最大数に達した、または最近作成した定期購入が多すぎることを示すエラーを返します。後者の場合は、数時間後にリクエストを再試行できます。badRequest (400)
invalidCategoryId
videos.update
メソッドはこのエラーを返し、アップロードされたvideo
リソースのsnippet.categoryId
プロパティで指定されたカテゴリ ID が無効であることを示します。videoCategories.list
メソッドを使用して、サポートされているカテゴリを取得します。badRequest (400)
invalidDescription
videos.update
メソッドは、アップロードされたvideo
リソースのsnippet.description
プロパティで無効な値が指定されていることを示すために、このエラーを返します。badRequest (400)
invalidPublishAt
videos.update
メソッドはこのエラーを返し、アップロードされたvideo
リソースのstatus.publishAt
プロパティに無効な予定公開時刻が指定されていることを示します。badRequest (400)
invalidRecordingDetails
videos.update
メソッドは、アップロードされたvideo
リソースのrecordingDetails
オブジェクトで無効な録音の詳細が指定されていることを示すために、このエラーを返します。badRequest (400)
invalidTags
videos.update
メソッドはこのエラーを返し、アップロードされたvideo
リソースのsnippet.tags
プロパティに無効な値が指定されていることを示します。badRequest (400)
invalidTitle
videos.update
メソッドは、アップロードされたvideo
リソースのsnippet.title
プロパティで無効な動画タイトルまたは空の動画タイトルが指定されていることを示すために、このエラーを返します。badRequest (400)
invalidVideoMetadata
videos.update
メソッドは、リクエスト メタデータが無効であることを示すためにこのエラーを返します。このエラーは、リクエストでvideo
リソースのsnippet
部分が更新されても、snippet.title
プロパティとsnippet.categoryId
プロパティの両方に値が設定されていない場合に発生します。
2015 年 12 月 18 日
欧州連合(EU)の法律では、EU 域内のエンドユーザーに対して特定の情報開示を行い、エンドユーザーから同意を得ることが義務付けられています。そのため、欧州連合のエンドユーザーについては、EU ユーザーの同意ポリシーに準拠する必要があります。YouTube API 利用規約に、この要件に関するお知らせを追加しました。
2015 年 11 月 19 日
この API では、playlist
リソースと video
リソースの snippet.title
プロパティと snippet.description
プロパティ、channelSection
リソースの snippet.title
プロパティ、channel
リソースの snippet.description
プロパティについて、ローカライズされたテキストを設定および取得できるようになりました。
-
ローカライズされたタイトルと説明を設定する
リソースのローカライズされた値は、そのリソースの
insert
またはupdate
メソッドを呼び出すときに設定できます。リソースにローカライズされた値を設定するには、次の両方を行います。-
リソースの
snippet.defaultLanguage
プロパティに値が設定されていることを確認します。このプロパティにより、リソースのsnippet.title
プロパティとsnippet.description
プロパティの言語が識別されます。値には、サポートされているアプリケーション言語またはその他ほとんどの ISO 639-1:2002 言語コードを使用できます。たとえば、英語のタイトルと説明を含む動画をアップロードする場合は、snippet.defaultLanguage
プロパティをen
に設定します。channel
リソースの更新に関する注:channel
リソースのsnippet.defaultLanguage
プロパティを設定するには、実際にbrandingSettings.channel.defaultLanguage
プロパティを更新する必要があります。 -
更新するリソースに
localizations
オブジェクトを追加します。各オブジェクト キーは、アプリケーションの言語または ISO 639-1:2002 言語コードを識別する文字列です。各キーは、リソースのローカライズされたタイトル(と説明)を含むオブジェクトにマッピングされます。以下のスニペットの例では、リソースのデフォルト言語を英語に設定しています。また、ドイツ語とスペイン語のローカライズされたタイトルと説明を動画に追加します。
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
重要: リソースのローカライズ済みデータを更新する場合は、そのデータの既存のローカライズ版をすべて API リクエストに含めてください。たとえば、上記の例で動画にポルトガル語のデータを追加するリクエストを送信した場合、このリクエストにはドイツ語、スペイン語、ポルトガル語のローカライズ済みデータを含める必要があります。
-
-
ローカライズされた値の取得
この API では、リソースのローカライズされた値を取得する 2 つの方法がサポートされています。
-
channels.list
、channelSections.list
、playlists.list
、またはvideos.list
リクエストにhl
パラメータを追加して、YouTube ウェブサイトがサポートする特定のアプリケーション言語用にローカライズされたデータを取得します。その言語でローカライズされたリソースの詳細が利用可能な場合、リソースのsnippet.localized
オブジェクトにはローカライズされた値が含まれます。ただし、ローカライズされた詳細情報を利用できない場合、snippet.localized
オブジェクトにはリソースのデフォルトの言語でリソースの詳細が格納されます。たとえば、
videos.list
リクエストで、上記の動画のローカライズされたドイツ語とスペイン語のデータが取得されたとします。hl
パラメータがde
に設定されている場合、リソースには次のデータが含まれます。{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
ただし、
hl
パラメータがfr
に設定されている場合、snippet.localized
オブジェクトには英語のタイトルと説明が含まれます。これは、英語がリソースのデフォルト言語であり、ローカライズされたフランス語の詳細が使用できないためです。重要:hl
パラメータは、YouTube ウェブサイトでサポートされているアプリケーション言語を識別する値のみをサポートします。ローカライズされたテキストを他の言語で使用できるかどうかを判断するには、リソースのlocalizations
部分を取得し、ローカライズされたテキストが存在するかどうかを判断するためにフィルタする必要があります。
たとえば、ローカライズされたテキストがアパラチア英語で使用できるかどうかを判断するには、ローカライズされたテキストの完全なリストを取得する必要があります。
-
リソースを取得するときに、
part
パラメータ値にlocalizations
を含めて、そのリソースのローカライズされた詳細情報をすべて取得します。現在の YouTube アプリケーションの言語ではない言語のローカライズ データを取得する場合は、この方法ですべてのローカライズを取得し、フィルタして目的のローカライズ データが存在するかどうかを判断する必要があります。
-
-
ローカライズされたテキスト値に関連するエラー
API では、ローカライズされたテキスト値に関する次の新しいエラーもサポートしています。
エラーのタイプ エラーの詳細 説明 badRequest (400)
defaultLanguageNotSetError
このエラーは、リソースの snippet.defaultLanguage
プロパティが設定されていないために、リソースのlocalizations
オブジェクトを挿入または更新しようとするリクエストが失敗したことを示します。channels.update
、channelSections.insert
、channelSections.update
、playlists.insert
、playlists.update
、videos.insert
、videos.update
の各メソッドがこのエラーをサポートしています。badRequest (400)
localizationValidationError
このエラーは、リソースの localizations
オブジェクトの値のいずれかが検証に失敗したことを示します。たとえば、オブジェクトに無効な言語コードが含まれている場合に、このエラーが発生します。channels.update
、channelSections.insert
、channelSections.update
、playlists.insert
、playlists.update
の各メソッドがこのエラーをサポートしています。
2015 年 11 月 4 日
この改訂での変更内容は次のとおりです:
-
既存のリソースとメソッドの更新
-
search.list
メソッドのorder
パラメータが更新され、ライブ配信をviewCount
で並べ替えると、ブロードキャストが進行中に API の結果が配信の同時視聴者数の順に並べられることに留意してください。 -
search.list
メソッドのrelatedToVideoId
パラメータが更新され、このパラメータが設定されている場合、サポートされる他のパラメータはpart
、maxResults
、pageToken
、regionCode
、relevanceLanguage
、safeSearch
、type
(video
に設定する必要があります)、fields
のみであることが明記されました。この更新によって API の動作が変更されることはありません。 -
video
リソースのsnippet.publishedAt
プロパティの定義が更新され、動画の公開日時を指定するプロパティ値が、動画のアップロード日時と異なる可能性があることが明記されました。たとえば、動画を非公開動画としてアップロードし、後で公開した場合、プロパティ値には動画が公開された時刻を指定します。更新された定義では、非公開動画と限定公開動画の値が入力される仕組みについても説明しています。この変更は API の動作の変更を反映していません。
-
video
リソースのstatus.publishAt
プロパティの定義が更新され、以下の点に注目しました。videos.update
メソッドの呼び出し時にこのプロパティの値を設定する場合は、動画がすでに非公開になっている場合でも、status.privacyStatus
プロパティの値をprivate
に設定する必要があります。- リクエストによって動画が過去の時間に公開されるようスケジュール設定されている場合、その動画はすぐに公開されます。そのため、
status.publishAt
プロパティを過去の日時に設定すると、動画のprivacyStatus
をprivate
からpublic
に変更する場合と同じ結果になります。
-
video
リソースのcontentDetails.contentRating.cncRating
プロパティは、フランスの分類映画撮影委員会による動画の評価を指定します。このプロパティは、非推奨となったcontentDetails.contentRating.fmocRating
プロパティに代わるものです。 -
channel
リソースの brandingSettings.channel.keywords の定義が更新され、プロパティ値にカンマ区切りのリストではなく、スペース区切りの文字列のリストが含まれていることが正しく反映されました。この更新によって API の動作が変更されることはありません。 -
thumbnails.set
メソッドのドキュメントを更新し、リクエスト本文にアップロードして動画に関連付けるサムネイル画像が含まれていることを正確に反映しました。リクエストの本文にthumbnail
リソースが含まれていません。以前のドキュメントでは、このメソッドを呼び出すときはリクエスト本文を指定すべきではないと記載されていました。この更新は API の動作の変更を反映していません。 -
activity
リソースの説明が更新され、現在activities.list
メソッドに新しい動画コメントに関連するリソースが含まれていないことが反映されました。リソースのsnippet.type
とcontentDetails.comment
も更新されました。
-
-
新しいエラーと更新されたエラー
-
API で次のエラーがサポートされるようになりました。
エラーの詳細 activities.insert
HTTP レスポンス コード badRequest (400)
理由 invalidMetadata
説明 kind
プロパティは、指定された ID のタイプと一致しません。commentThreads.update
comments.insert
comments.update
HTTP レスポンス コード badRequest (400)
理由 commentTextTooLong
説明 挿入または更新される comment
リソースのsnippet.topLevelComment.snippet.textOriginal
プロパティに文字が多すぎます。playlistItems.insert
playlistItems.update
HTTP レスポンス コード forbidden (403)
理由 playlistItemsNotAccessible
説明 指定された再生リストのアイテムを挿入、更新、削除する権限がリクエストに適切に付与されていません。 playlists.delete
playlists.insert
playlists.update
HTTP レスポンス コード badRequest (400)
理由 playlistForbidden
説明 このオペレーションは禁止されているか、リクエストが適切に承認されていません。 search.list
HTTP レスポンス コード badRequest (400)
理由 invalidLocation
説明 location
またはlocationRadius
パラメータ値の形式が正しくありません。search.list
HTTP レスポンス コード badRequest (400)
理由 invalidRelevanceLanguage
説明 relevanceLanguage
パラメータ値の形式が正しくありません。subscriptions.insert
HTTP レスポンス コード badRequest (400)
理由 subscriptionForbidden
説明 このエラーは、次のいずれかに該当する場合に発生します。 - 作成しようとしている定期購入はすでに存在しています
- サブスクリプションの最大数に達している
- ご自身のチャンネルを登録しようとしていますが、これはサポートされていません。
- 最近作成したサブスクリプションの数が多すぎます。数時間待ってからリクエストを再試行してください。
videos.update
HTTP レスポンス コード badRequest (400)
理由 invalidDefaultBroadcastPrivacySetting
説明 リクエストで、デフォルトのブロードキャストに無効なプライバシー設定を設定しようとしています。
-
2015 年 8 月 28 日
この改訂での変更内容は次のとおりです:
-
既存のリソースとメソッドの更新
-
video
リソースのstatistics.favoriteCount
プロパティは非推奨になりました。非推奨ポリシーに従い、このプロパティは、このお知らせから少なくとも 1 年間は
video
リソースに引き続き含まれます。ただし、プロパティ値は常に0
に設定されるようになりました。
-
2015 年 8 月 7 日
この改訂での変更内容は次のとおりです:
-
既存のリソースとメソッドの更新
-
video
リソースのsnippet.tags[]
プロパティの定義が更新され、API サーバーによるプロパティ値の長さの計算方法の詳細が記載されるようになりました。この更新は、API の動作の変更を反映するものではありません。具体的には、タグにスペースが含まれている場合、API サーバーはタグ値を引用符で囲んだかのように処理し、引用符は文字数制限に計上されることが定義で説明されるようになりました。そのため、文字数制限を考慮して、Foo-Baz タグには 7 文字が含まれていますが、Foo Baz タグには 9 文字が含まれています。
-
commentThreads.insert
メソッドでshareOnGooglePlus
パラメータがサポートされなくなりました。このパラメータは、コメントとそのコメントへの返信を投稿者の Google+ プロフィールにも投稿するかどうかを指定していました。リクエストがパラメータを送信した場合、API サーバーはパラメータを無視しますが、それ以外の場合はリクエストを処理します。
-
2015 年 6 月 18 日
この改訂での変更内容は次のとおりです:
-
既存のリソースとメソッドの更新
-
commentThreads.list
メソッドの新しいorder
パラメータは、API レスポンスでコメント スレッドを一覧表示する順序を指定します。スレッドは、時間または関連性で並べ替えることができます。デフォルトでは、時系列順に並べられます。 -
video
リソースの新しいsnippet.defaultAudioLanguage
プロパティは、動画のデフォルトの音声トラックで使用される言語を指定します。 -
video
リソースのcontentDetails.licensedContent
プロパティの定義が更新され、コンテンツが最初に YouTube コンテンツ パートナーにリンクされたチャンネルにアップロードされ、そのパートナーによって申し立てが行われている必要があることが明記されました。これは実際の API の動作の変更を意味するものではありません。 -
captions.delete
、captions.download
、captions.insert
、captions.list
、captions.update
の各メソッドでonBehalfOfContentOwner
パラメータがサポートされるようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。このメソッドを使用するリクエストも、https://www.googleapis.com/auth/youtubepartner
スコープへのアクセスを提供するトークンでも承認する必要があります。
-
-
新しいエラーと更新されたエラー
-
API で次のエラーがサポートされるようになりました。
エラーの詳細 videos.rate
HTTP レスポンス コード badRequest (400)
理由 emailNotVerified
説明 ユーザーは、動画を評価する前にメールアドレスを確認する必要があります。 videos.rate
HTTP レスポンス コード badRequest (400)
理由 videoPurchaseRequired
説明 レンタル動画は、レンタルしたユーザーのみが評価できます。 -
subscriptions.delete
メソッドとsubscriptions.insert
メソッドは、accountClosed
エラーとaccountSuspended
エラーをサポートしなくなりました。
-
2015 年 4 月 27 日
この改訂での変更内容は次のとおりです:
-
新しいリソースとメソッド
-
新しい
videoAbuseReportReason
リソースには、不適切なコンテンツを含むとして動画が報告される理由に関する情報が含まれています。videoAbuseReportReasons.list
メソッドを使用すると、動画が報告される可能性があるすべての理由のリストを取得できます。 -
新しい
videos.reportAbuse
メソッドを使用すると、不適切なコンテンツを含む動画を実際に報告できます。リクエストの本文には、報告対象の動画と、動画に不適切なコンテンツが含まれていると判断された理由を指定する JSON オブジェクトが含まれます。正当な理由は、上記のvideoAbuseReportReason.list
メソッドから取得できます。また、移行ガイドも更新され、不正な動画を報告する例が追加されました。この変更により、今後サポート予定のすべての v2 API 機能が v3 API でサポートされるようになります。これらの機能についても、移行ガイドで詳しく説明しています。
-
-
既存のリソースとメソッドの更新
-
search.list
メソッドの新しいforDeveloper
フィルタ パラメータを使用すると、デベロッパーのアプリまたはウェブサイトからアップロードされた動画のみを検索できます。forDeveloper
パラメータは、q
パラメータなどのオプションの検索パラメータと組み合わせて使用できます。この機能では、アップロードされた各動画に、Google デベロッパー コンソールでデベロッパーのアプリに関連付けられているプロジェクト番号が自動的にタグ付けされます。
その後、検索リクエストで
forDeveloper
パラメータをtrue
に設定すると、API サーバーはリクエストの認可認証情報を使用してデベロッパーを識別します。そのため、デベロッパーは、デベロッパー独自のアプリまたはウェブサイトからアップロードされた動画に結果を制限できますが、他のアプリやサイトからアップロードされた動画には制限できません。この新機能で提供される機能は、v2 API がサポートしていたデベロッパー タグ機能と同一ではありませんが、ほぼ同じです。
-
channel
リソースの新しいsnippet.country
プロパティを使用すると、チャンネル所有者はチャンネルを特定の国に関連付けることができます。注:
channel
リソースのsnippet.country
プロパティを設定するには、実際にはbrandingSettings.channel.country
プロパティを更新する必要があります。 -
API で
channelSection
リソースのターゲティングがサポートされるようになりました。チャンネル セクション ターゲティングを使用すると、特定の条件に一致するユーザーにのみコンテンツ セクションを表示できます。この API には、次の 3 つのターゲティング オプションがあります。チャンネル セクションが表示されるには、ユーザーがすべてのターゲット設定を満たしている必要があります。
-
targeting.languages[]
: YouTube アプリケーション言語のリスト。これらの言語のいずれかを選択したユーザーには、対応するチャンネルのセクションが表示されます。 -
targeting.regions[]
: YouTube の優先コンテンツ領域のリスト。チャンネル セクションは、これらの地域のいずれかを選択したユーザーと、これらの地域のいずれかが自動的に選択されたユーザーに表示されます。 -
targeting.countries[]
: チャンネル セクションが表示される国のリスト。リスト内の各値は ISO 3166-1 alpha-2 国コードです。
-
-
video
リソースのcontentDetails.duration
プロパティの定義を修正し、値に時間や日数などを反映できることを反映しました。 -
channelSections.delete
、playlistItems.delete
、playlists.delete
、subscriptions.delete
、videos.delete
メソッドのドキュメントを修正し、成功した場合、これらのメソッドはすべて HTTP204
レスポンス コード(No Content
)を返すことを反映しました。
-
-
新しいエラーと更新されたエラー
-
この API は、次のエラーをサポートするようになりました。
エラーのタイプ エラーの詳細 説明 badRequest (400)
targetInvalidCountry
挿入された channelSection
リソースにtargeting.countries[]
プロパティの無効な値が含まれている場合、channelSections.insert
メソッドとchannelSections.update
メソッドは、このエラーを返します。badRequest (400)
targetInvalidLanguage
挿入された channelSection
リソースにtargeting.languages[]
プロパティの無効な値が含まれている場合、channelSections.insert
メソッドとchannelSections.update
メソッドは、このエラーを返します。badRequest (400)
targetInvalidRegion
挿入された channelSection
リソースにtargeting.regions[]
プロパティの無効な値が含まれている場合、channelSections.insert
メソッドとchannelSections.update
メソッドは、このエラーを返します。badRequest (400)
operationNotSupported
snippet.parentId
プロパティで識別されたトップレベル コメントに API ユーザーがコメントを挿入できない場合、comments.insert
メソッドはこのエラーを返します。commentThread
リソースのsnippet.canReply
プロパティは、現在の視聴者がスレッドに返信できるかどうかを示します。badRequest (400)
invalidChannelId
リクエストの channelId
パラメータで無効なチャンネル ID が指定されている場合、search.list
メソッドはこのエラーを返します。badRequest (400)
subscriptionForbidden
API ユーザーが自分のチャンネルを登録しようとすると、 subscriptions.insert
メソッドはこのエラーを返します。 -
captions.update
メソッドは、invalidMetadata
エラーとvideoNotFound
エラーをサポートしなくなりました。
-
2015 年 4 月 16 日
この改訂での変更内容は次のとおりです:
-
移行ガイドが更新され、v2 API のコメント機能を使用しているアプリケーションを移行する方法が説明されています。
また、v2 API ではサポートされていなかったが、v3 API でサポートされているコメント機能についても説明しています。次のようなアクセサリーが含まれます。
- チャンネルに関するコメントの取得
- チャンネルに関連するすべてのコメント スレッドを取得する。つまり、API レスポンスにチャンネルやその動画に関するコメントを含めることができます。
- コメントのテキストの更新
- コメントをスパムとして報告する
- コメントの管理ステータスの設定
-
プッシュ通知の登録ガイドを更新し、通知が Google PubSubHubBub ハブにのみプッシュされ、以前に記載されていたように Superfeedr ハブにはプッシュされないことを反映しました。
2015 年 4 月 9 日
この改訂での変更内容は次のとおりです:
-
API の新しい
commentThread
リソースとcomment
リソースを使用すると、コメントの取得、挿入、更新、削除、管理を行うことができます。-
commentThread
リソースには、YouTube のコメント スレッドに関する情報が含まれます。コメント スレッドは、トップレベルのコメントと、そのコメントに対する返信(存在する場合)で構成されます。commentThread
リソースは、動画またはチャンネルに関するコメントを表すことができます。最上位のコメントと返信は実際には
comment
リソースであり、commentThread
リソース内にネストされています。commentThread
リソースにコメントへのすべての返信が含まれているとは限りません。特定のコメントのすべての返信を取得するには、comments.list
メソッドを使用する必要があります。また、一部のコメントには返信がありません。この API では、
commentThread
リソースについて次のメソッドがサポートされています。commentThreads.list
- コメント スレッドのリストを取得します。このメソッドを使用して、特定の動画またはチャンネルに関連付けられているコメントを取得します。commentThreads.insert
- 新しいトップレベルのコメントを作成します。(既存のコメントに返信するには、comments.insert
メソッドを使用します)。commentThreads.update
– 最上位コメントを変更します。
-
comment
リソースには、1 つの YouTube コメントに関する情報が含まれます。comment
リソースは、動画またはチャンネルに関するコメントを表すことができます。このコメントは、トップレベルのコメントであっても、トップレベルのコメントに対する返信であってもかまいません。この API は、
comment
リソースの次のメソッドをサポートしています。comments.list
- コメントのリストを取得します。このメソッドを使用すると、特定のコメントへのすべての返信を取得できます。comments.insert
– 既存のコメントへの返信を作成します。comments.update
– コメントを変更します。comments.markAsSpam
- 1 つ以上のコメントをスパムとして報告します。comments.setModerationStatus
– 1 つ以上のコメントの管理ステータスを設定します。たとえば、コメントをクリアして一般公開したり、表示に適さないコメントとして拒否したりできます。API リクエストは、コメントに関連付けられているチャンネルまたは動画の所有者によって承認されている必要があります。comments.delete
- コメントを削除します。
なお、API の新しい
https://www.googleapis.com/auth/youtube.force-ssl
スコープ(2015 年 4 月 2 日の変更履歴に記載)は、comments.insert
、comments.update
、comments.markAsSpam
、comments.setModerationStatus
、comments.delete
、commentThreads.insert
、commentThreads.update
の各メソッドの呼び出しに必要です。 -
-
新しいプッシュ通知への登録ガイドでは、ウェブアクセス可能なリソースのためのサーバー間のパブリッシュ/サブスクライブ プロトコルである PubSubHubBub を介したプッシュ通知に対する API の新しいサポートについて説明しています。PubSubHubBub コールバック サーバーは、チャンネルで次のいずれかのアクティビティが発生したときに Atom フィード通知を受信できます。
- が動画をアップロードしました
- 動画のタイトルを更新する
- 動画の説明を更新する
-
移行ガイドも更新され、プッシュ通知の新しいサポートが記載されました。ただし、v2 API は v3 API でサポートされていない他の多くの種類のプッシュ通知をサポートしていたため、PubSubHubBub のサポートについては、そのガイドの非推奨のセクションに記載されています。
-
API の新しい
https://www.googleapis.com/auth/youtube.force-ssl
スコープは、これまでhttps://www.googleapis.com/auth/youtube
スコープをサポートしていたすべての API メソッドで有効なスコープになりました。 -
API で次のエラーがサポートされるようになりました。
エラーのタイプ エラーの詳細 説明 badRequest (400)
invalidRating
リクエストに rating
パラメータの予期しない値が含まれている場合、videos.rate
メソッドはこのエラーを返します。 -
subscriptions.insert
メソッドは、以前にリクエストで指定されたサブスクライバーがサブスクリプションのレート制限を超えたことを示すsubscriptionLimitExceeded
エラーをサポートしなくなりました。
2015 年 4 月 2 日
この改訂での変更内容は次のとおりです:
-
新しい
captions
リソースは、YouTube の字幕トラックを表します。字幕トラックは 1 つの YouTube 動画にのみ関連付けられます。 -
また、移行ガイドも更新され、v2 API のキャプション機能をまだ使用しているアプリケーションを移行する方法が説明されています。
-
API の新しい
https://www.googleapis.com/auth/youtube.force-ssl
スコープでは、API サーバーとの通信が SSL 接続を介して行われることが求められます。この新しいスコープは、
https://www.googleapis.com/auth/youtube
スコープと同じアクセス権を付与します。YouTube API サーバーは HTTPS エンドポイント経由でしか利用できないため、この 2 つのスコープは機能的に同一です。そのため、https://www.googleapis.com/auth/youtube
スコープは SSL 接続を必要としませんが、実際には API リクエストを行う他の方法がありません。新しいスコープは、
caption
リソースのすべてのメソッドの呼び出しに必要です。
2015 年 3 月 11 日
この改訂での変更内容は次のとおりです:
-
YouTube Data API(v3)移行ガイドに、v3 API の新機能という新しいタブが追加されました。このタブには、v3 API でサポートされているが v2 API ではサポートされていない機能の一覧が表示されます。以前と同じ機能であり、ガイドの他のタブに引き続き記載されています。たとえば、チャンネルの動画プロモーション キャンペーン データの更新方法を説明する新機能は、[チャンネル(プロフィール)] タブにも表示されます。
-
YouTube Data API(v3)移行ガイドが更新され、v3 API で次の v2 API 機能をサポートすることが記載されました。
-
YouTube Data API(v3)移行ガイドが更新され、v2 API の次の機能は v3 API でサポートされないことが明記されました。
-
動画のおすすめを取得する - v3 API は、現在の API ユーザーにおすすめの動画のみを含むリストを取得しません。ただし、v3 API を使用しておすすめの動画を見つけるには、
activities.list
メソッドを呼び出して、home
パラメータ値をtrue
に設定します。API レスポンスでは、
snippet.type
プロパティの値がrecommendation
の場合、リソースはおすすめ動画に対応します。その場合、contentDetails.recommendation.reason
プロパティとcontentDetails.recommendation.seedResourceId
プロパティには、動画がおすすめされた理由に関する情報が含まれます。ただし、レスポンスに特定の数のおすすめの動画が含まれる保証はありません。 -
新しいチャンネル登録動画を取得する - v3 API は、API ユーザーがチャンネル登録しているチャンネルに最近アップロードされた動画のみを含むリストを取得しません。ただし、v3 API を使用して
activities.list
メソッドを呼び出し、home
パラメータの値をtrue
に設定することで、新しい定期購入動画を見つけることができます。API レスポンスでは、
snippet.type
プロパティの値がupload
の場合、リソースは新しいチャンネル登録動画に対応します。レスポンスに特定の数の新しいチャンネル登録動画が含まれる保証はありません。 -
フィード更新のプッシュ通知 – v2 API では、シンプル アップデート プロトコル(SUP)または PubSubHubbub を使用したプッシュ通知で、YouTube ユーザーのアクティビティ フィードを監視できます。新しいチャンネル登録、動画の評価、共有、お気に入り登録、コメント、アップロードの際に通知が届きました。
v3 API は PubSubHubbub プロトコルを使用したプッシュ通知をサポートしますが、通知は動画のアップロードと動画のタイトルまたは動画の説明の更新にのみ適用されます。
-
チャンネルの位置情報 - v2 API では、
<yt:location>
タグを使用して、チャンネルの YouTube 公開プロフィールに入力されたユーザーの位置情報を特定していました。このフィールドを使用してチャンネルを特定の国に関連付けたデベロッパーもいますが、このフィールドのデータをその目的に一貫して使用することはできませんでした。 -
デベロッパー タグの設定または取得 – v2 API では、キーワードやデベロッパー タグを動画のアップロード時に動画に関連付ける機能がサポートされていました。デベロッパー タグは YouTube ユーザーには表示されませんが、動画の所有者は特定のデベロッパー タグに一致する動画を取得できます。
v3 API は、同様の機能を提供しますが、同一ではありません。具体的には、デベロッパーは、デベロッパー独自のアプリによってアップロードされた動画を検索できるようになります。この機能では、アップロードされた各動画には、Google Developers Console でデベロッパーのアプリケーションに関連付けられているプロジェクト番号が自動的にタグ付けされます。その後、デベロッパーは同じプロジェクト番号を使用して動画を検索します。
-
公開日、視聴回数、評価で動画を一覧表示する - v2 API の
orderby
パラメータを使用すると、再生リスト内の動画を位置、長さ、公開日、タイトル、その他の値で並べ替えることができます。v3 API では、通常、再生リストのアイテムは位置順で昇順に並べ替えられ、他の並べ替えオプションは使用できません。ただし、次のような例外があります。次の種類の再生リストでは、新しくアップロードされた動画、お気に入りの動画、高く評価した動画、最近視聴した動画が最初のアイテム(
snippet.position
=0
)として自動的に追加されます。そのため、これらの各リストは、リストにアイテムが追加された時刻に基づいて、新しいアイテムから最も古いアイテムの順に効果的に並べ替えられます。- ユーザーによるアップロード
- お気に入りの動画
- 高く評価した動画
- 再生履歴
ただし、[後で見る] 再生リストに追加された新しいアイテムは、リストの最後のアイテムとして追加されるため、リストが古いものから新しいものへと効果的に並べ替えられます。
-
バッチ処理 – v3 API は、v2 API がサポートしていたバッチ処理のユースケースの一つをサポートしています。v3 API の
channels.list
、channelSections.list
、guideCategories.list
、playlistItems.list
、playlists.list
、subscriptions.list
、videoCategories.list
、videos.list
メソッドはすべてid
パラメータをサポートしています。このパラメータを使用すると、ID(動画 ID、チャンネル ID など)のカンマ区切りリストを指定できます。これらのメソッドを使用すると、1 回のリクエストで複数のリソースのリストを取得できます。
これらの変更に伴い、現在の API バージョン(v3)で非推奨となる古い(v2)API でサポートされていたすべての機能をガイドで特定できるようになりました。
-
2015 年 3 月 4 日
この改訂での変更内容は次のとおりです:
-
channelSections.delete
メソッドとchannelSections.update
メソッドでonBehalfOfContentOwner
パラメータがサポートされるようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。 -
次のプロパティとその子プロパティのサポートは終了しました。
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
注: これらのプロパティはいずれも API のサポート終了ポリシーの対象になっていませんでした。
-
video
リソースの新しいcontentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
プロパティには、動画が DJCQT(ブラジル)のレーティングを受けた理由が示されます。 -
API で次のエラーがサポートされるようになりました。
エラーのタイプ エラーの詳細 説明 notFound (404)
channelNotFound
リクエストの id
パラメータに見つからないチャンネルが指定されている場合、channels.update
メソッドはこのエラーを返します。badRequest (400)
manualSortRequiredinvalidValue
playlistItems.insert
メソッドとplaylistItems.update
メソッドは、リクエストで再生リストアイテムの位置を設定しようとしたが、再生リストで手動の並べ替えが使用されていない場合に、このエラーを返します。たとえば、再生リストのアイテムを日付や人気度で並べ替えることができます。このエラーに対処するには、リクエスト本文で送信されるリソースからsnippet.position
要素を削除します。プレイリスト アイテムをリスト内の特定の位置に配置するには、まずプレイリストの並べ替え設定を [手動] に更新する必要があります。この設定は、YouTube 動画の管理で調整できます。forbidden (403)
channelClosed
リクエストの channelId
パラメータで閉じられたチャネルが指定されている場合、playlists.list
メソッドはこのエラーを返します。forbidden (403)
channelSuspended
リクエストの channelId
パラメータで停止中のチャネルが指定されている場合、playlists.list
メソッドはこのエラーを返します。forbidden (403)
playlistForbidden
リクエストの id
パラメータがリクエストをサポートしていないか、リクエストが適切に承認されていない場合、playlists.list
メソッドはこのエラーを返します。notFound (404)
channelNotFound
リクエストの channelId
パラメータに見つからないチャンネルが指定されている場合、playlists.list
メソッドはこのエラーを返します。notFound (404)
playlistNotFound
リクエストの id
パラメータで見つからない再生リストが指定されている場合、playlists.list
メソッドはこのエラーを返します。notFound (404)
videoNotFound
見つからない動画がリクエストの id
パラメータに指定されている場合、videos.list
メソッドはこのエラーを返します。badRequest (400)
invalidRating
リクエストに rating
パラメータの予期しない値が含まれている場合、videos.rate
メソッドはこのエラーを返します。
2015 年 3 月 2 日
この改訂での変更内容は次のとおりです:
-
search.list
メソッドでrelevanceLanguage
パラメータがサポートされるようになりました。これにより、特定の言語に最も関連性の高い結果をリクエストできます。YouTube Data API(v3)移行ガイドも更新され、この新しいパラメータの使用方法が説明されています。このパラメータは、現在の API バージョン(v3)と、すでに非推奨となっている以前のバージョン(v2)との間に存在していた機能の違いに対処します。
-
YouTube Data API(v3)移行ガイドも更新され、映画、予告編、テレビ番組、テレビシーズン、テレビエピソードの記述に v2 API が提供していた特別なフィードとメタデータ フィールドのサポート終了が示されました。
2015 年 1 月 14 日
この改訂での変更内容は次のとおりです:
-
YouTube Data API(v3)移行ガイドが更新され、v3 API を使用して JavaScript で動画をアップロードする方法が説明されています。(詳しくは、動画をアップロードするをご覧ください)。この機能は、v2 API がサポートするブラウザベースのアップロード機能に相当します。なお、この移行ガイドの変更は、実際の API の変更を反映したものではなく、クライアントサイド JavaScript を使用して動画をアップロードするための新しいサンプルコードの提供を反映したものです。
JavaScript クライアント ライブラリと CORS を使用した動画のアップロードのサポートに伴い、移行ガイドには、v3 API でサポートが終了する可能性のある機能としてブラウザベースのアップロードが記載されなくなりました。
-
videos.insert
メソッドのドキュメントが更新され、上記の新しい JavaScript コードサンプルが追加されました。YouTube Data API(v3)の JavaScript コードサンプルのリストも更新されました。
2014 年 11 月 11 日
この改訂での変更内容は次のとおりです:
-
search.list
メソッドの呼び出しに対する割り当て費用が 100 ユニットに変更されました。重要: 多くの場合、他の API メソッドを使用して、より低い割り当てコストで情報を取得できます。たとえば、GoogleDevelopers チャンネルにアップロードされた動画を検索する方法は次の 2 つです。
-
割り当ての費用: 100 ユニット
search.list
メソッドを呼び出して、GoogleDevelopers
を検索します。 -
割り当て費用: 6 ユニット
channels.list
メソッドを呼び出して、正しいチャンネル ID を見つけます。forUsername
パラメータをGoogleDevelopers
に設定し、part
パラメータをcontentDetails
に設定します。API レスポンスでは、contentDetails.relatedPlaylists.uploads
プロパティにはチャンネルにアップロードされた動画の再生リスト ID を指定します。次に、
playlistItems.list
メソッドを呼び出して、キャプチャした ID にplaylistId
パラメータを設定し、part
パラメータをsnippet
に設定します。
-
2014 年 10 月 8 日
この改訂での変更内容は次のとおりです:
-
channel
リソースには、次の 2 つの新しいプロパティが含まれています。-
status.longUploadsStatus
プロパティは、チャンネルが 15 分を超える動画をアップロードできるかどうかを示します。このプロパティは、チャンネル所有者が API リクエストを承認した場合にのみ返されます。有効なプロパティ値は以下のとおりです。allowed
- チャンネルは 15 分を超える動画をアップロードできます。eligible
– チャンネルは 15 分を超える動画をアップロードできますが、最初にこの機能を有効にする必要があります。disallowed
- チャンネルは 15 分を超える動画をアップロードできないか、アップロードする資格がありません。
これらの値の詳細については、プロパティの定義をご覧ください。この機能について詳しくは、YouTube ヘルプセンターでもご確認いただけます。
-
invideoPromotion.useSmartTiming
プロパティは、チャンネルのプロモーション キャンペーンで「スマートなタイミング」が使用されているかどうかを示します。この機能は、クリックされる可能性が高い一方で、視聴体験を妨げにくい動画のタイミングでプロモーションを表示しようとします。また、各動画に表示するプロモーションが 1 つ選択されます。
-
-
video
リソースのsnippet.title
プロパティとsnippet.categoryId
プロパティの定義が更新され、API がvideos.update
メソッドの呼び出しを処理する方法が明確化されました。このメソッドを呼び出してvideo
リソースのsnippet
部分を更新する場合は、両方のプロパティに値を設定する必要があります。video
リソースのsnippet
部分を更新しようとしたときに、これらのプロパティの両方に値を設定していない場合、API はinvalidRequest
エラーを返します。エラーの説明も更新されています。 -
ニュージーランド映画文学分類庁による動画のレーティングを識別する
video
リソースのcontentDetails.contentRating.oflcRating
プロパティで、oflcRp13
とoflcRp16
の 2 つの新しいレーティングがサポートされるようになりました。これらは、それぞれRP13
評価とRP16
評価に対応します。 -
channelBanners.insert
メソッドが次のエラーをサポートするようになりました。エラーのタイプ エラーの詳細 説明 badRequest
bannerAlbumFull
チャンネル所有者の YouTube チャンネル アート アルバムに含まれる画像が多すぎます。チャンネル所有者は、http://photos.google.com にアクセスしてアルバムページに移動し、アルバムの画像から画像の一部を削除する必要があります。
2014 年 9 月 12 日
この改訂での変更内容は次のとおりです:
-
指定したリソース パーツのコストに加えて、
search.list
メソッドの呼び出しに対する割り当てコストが 1 ユニットから 2 ユニットに変更されました。
2014 年 8 月 13 日
この改訂での変更内容は次のとおりです:
-
subscriptions.insert
メソッドが次のエラーをサポートするようになりました。エラーのタイプ エラーの詳細 説明 badRequest
subscriptionLimitExceeded
リクエストで識別されたサブスクライバーが、サブスクリプションのレート制限を超えました。数時間後に追加の定期購入をお試しいただけます。
2014 年 8 月 12 日
この改訂での変更内容は次のとおりです:
-
「アプリケーションを YouTube Data API(v3)に移行する」というタイトルの新しいガイドでは、YouTube Data API(v3)を使用して、YouTube Data API(v2)の機能を実行する方法を説明しています。古い API は、2014 年 3 月 4 日をもって正式に非推奨となりました。このガイドは、v2 API を引き続き使用しているアプリを最新の API バージョンに移行する際に役立つことを目的としています。
2014 年 7 月 8 日
この改訂での変更内容は次のとおりです:
-
playlists.insert
メソッドが次のエラーをサポートするようになりました。エラーのタイプ エラーの詳細 説明 badRequest
maxPlaylistExceeded
このエラーは、チャンネルに許可されているプレイリストの最大数に達しているため、プレイリストを作成できない場合に発生します。
2014 年 6 月 18 日
この改訂での変更内容は次のとおりです:
-
各 API メソッドの説明が更新され、そのメソッドの呼び出しによって発生する割り当て費用が追加されました。同様に、
part
パラメータの定義が更新され、API 呼び出しで取得できる各パーツの割り当てコストが指定されます。たとえば、subscriptions.insert
メソッドの呼び出しでは、割り当て費用が約 50 ユニットになります。subscription
リソースにも 3 つの部分(snippet
、contentDetails
、subscriberSnippet
)があり、それぞれ 2 ユニットの費用がかかります。割り当て費用は予告なく変更される場合があります。
-
video
リソースが 43 の新しいコンテンツのレーティング システムをサポートするようになりました。このシステムは、各国のさまざまなレーティング機関から動画に対するレーティングを特定します。
2014 年 5 月 28 日
この改訂での変更内容は次のとおりです:
-
search.list
メソッドでlocation
パラメータとlocationRadius
パラメータがサポートされるようになりました。これにより、地理的位置に関連付けられた動画を検索できるようになりました。場所に基づいて結果を取得するには、リクエストで両方のパラメータの値を指定する必要があります。リクエストに 2 つのパラメータの 1 つしか含まれていない場合、API はエラーを返します。-
location
パラメータには、円形の地理範囲の中心の緯度と経度の座標を指定します。 -
locationRadius
パラメータは、動画を検索結果に表示させるための領域の中心から、動画に関連付けられている場所までの最大距離を指定します。
-
2014 年 5 月 13 日
この改訂での変更内容は次のとおりです:
-
channel
リソースのinvideoPromotion.items[]
プロパティが更新され、通常、チャンネルに設定できるプロモーション アイテムは 1 つのみです。挿入しようとするプロモート アイテムの数が多すぎると、API からtooManyPromotedItems
エラーが返されます。このエラーには、HTTP400
ステータス コードが含まれます。 -
channelSection
リソースに、新しいタイプの注目のコンテンツに関する情報を含められるようになりました。channelSection
リソースのsnippet.type
プロパティが次の値をサポートするようになりました。postedPlaylists
- チャンネルの所有者がチャンネルのアクティビティ フィードに投稿した再生リストpostedVideos
- チャンネルの所有者がチャンネルのアクティビティ フィードに投稿した動画subscriptions
- チャンネル所有者がチャンネル登録しているチャンネル
-
video
リソースの新しいcontentDetails.contentRating.ifcoRating
プロパティは、アイルランド映画分類局から動画が受け取ったレーティングを識別します。 -
watermark
リソースのposition.cornerPosition
プロパティの定義が更新され、透かしが常にプレーヤーの右上隅に表示されるようになりました。 -
search.list
メソッドのq
パラメータの定義が更新され、クエリ語句でブール演算子 NOT(-
)を使用して、特定の検索語句に関連付けられた動画を除外できることが明記されました。値にブール演算子 OR(|
)を使用して、複数の検索キーワードのいずれかに関連する動画を検索することもできます。 -
search.list
呼び出しに対する API レスポンスで返されるpageInfo.totalResults
プロパティの定義が更新され、値は近似値であり、正確な値を表すものではないことが明記されました。また、最大値は 1,000,000 です。この値は、ページネーション リンクの作成には使用しないでください。代わりに、nextPageToken
プロパティとprevPageToken
プロパティ値を使用して、ページ分けのリンクを表示するかどうかを決定します。 -
watermarks.set
メソッドとwatermarks.unset
メソッドが更新され、API がこれらのメソッドへのリクエストが成功すると HTTP204
レスポンス コードを返すことが反映されるようになりました。
2014 年 5 月 2 日
この改訂での変更内容は次のとおりです:
-
新しい
i18nLanguage
リソースは、YouTube ウェブサイトがサポートするアプリケーション言語を識別します。アプリケーション言語は UI 言語とも呼ばれます。YouTube ウェブサイトの場合、アプリケーションの言語は Google アカウントの設定、ブラウザの言語、IP 位置情報に基づいて自動的に選択することも、ユーザーが YouTube サイトのフッターから希望の UI 言語を手動で選択することもできます。この API は、サポートされているアプリケーション言語を一覧表示するメソッドをサポートしています。
videoCategories.list
やguideCategories.list
などの API メソッドを呼び出すときに、サポートされている言語をhl
パラメータの値として使用できます。 -
新しい
i18nRegion
リソースは、YouTube ユーザーが優先コンテンツ地域として選択できる地域を識別します。コンテンツの地域は、コンテンツの言語 / 地域とも呼ばれます。YouTube ウェブサイトの場合、コンテンツの地域は YouTube ドメインやユーザーの IP ロケーションなどのヒューリスティックに基づいて自動的に選択することも、ユーザーが YouTube サイトのフッターから希望のコンテンツ地域を手動で選択することもできます。この API は、サポートされているコンテンツ領域を一覧表示するメソッドをサポートしています。
search.list
、videos.list
、activities.list
、videoCategories.list
などの API メソッドを呼び出すときに、サポートされているリージョン コードをregionCode
パラメータの値として使用できます。
2014 年 4 月 7 日
この改訂での変更内容は次のとおりです:
-
新しい
channelSection
リソースには、チャンネルがおすすめする一連の動画に関する情報が含まれます。たとえば、チャンネルの最新のアップロード、人気のアップロード、1 つ以上の再生リストの動画などが表示されます。この API は、チャンネルのセクションを一覧表示、挿入、更新、削除するメソッドをサポートしています。認証済みユーザーのチャンネルのチャンネル セクションのリストを取得するには、特定のチャンネル ID を指定するか、一意のチャンネル セクション ID のリストを指定します。
エラー ドキュメントも更新され、API がこれらの新しいメソッド用にサポートするエラー メッセージについて説明しています。
-
video
リソースのfileDetails
オブジェクトの定義が更新され、このオブジェクトは動画のprocessingDetails.fileDetailsAvailability
プロパティの値がavailable
の場合にのみ返されることが説明されています。同様に、
video
リソースのsuggestions
オブジェクトの定義が更新され、動画のprocessingDetails.tagSuggestionsAvailability
プロパティまたはそのprocessingDetails.editorSuggestionsAvailability
プロパティの値がavailable
の場合にのみ、そのオブジェクトが返されることが明記されました。 -
videos.insert
メソッドとvideos.update
メソッドのドキュメントを更新し、これらのメソッドの呼び出し時にstatus.publishAt
プロパティを設定できることを反映しました。 -
channel
リソースのinvideoPromotion
オブジェクトの定義が更新され、このオブジェクトを取得できるのはチャンネルの所有者のみであることが説明されました。 -
videos.rate
メソッドのパラメータリストが更新され、このメソッドが実際にはonBehalfOfContentOwner
パラメータをサポートしていないことが反映されました。このパラメータを設定するvideos.rate
リクエストは500
エラーを返すため、これはドキュメントのエラーでした。
2014 年 3 月 31 日
この改訂での変更内容は次のとおりです:
-
video
リソースの新しいstatus.publishAt
プロパティを使用すると、非公開動画の公開スケジュール日時を指定できます。このプロパティは、動画のプライバシー ステータスがprivate
で、動画が公開されたことがない場合にのみ設定できます。この新しいプロパティは非推奨ポリシーの対象外です。
2014 年 3 月 13 日
この改訂での変更内容は次のとおりです:
-
API で、
channel
リソースのcontentOwnerDetails
部分がサポートされるようになりました。新しい部分には、チャンネルにリンクされているコンテンツ所有者の ID、コンテンツ所有者とチャンネルがリンクされた日時など、チャンネルにリンクされた YouTube パートナーに関連するチャンネル データが含まれます。この新しいパーツは非推奨ポリシーの対象外です。 -
ドキュメントに、次のプロパティでサポートされる最大文字数が記載されるようになりました。
リソース プロパティ Maximum length channel
invideoPromotion.items[].customMessage
40 文字 video
snippet.title
100 文字 video
snippet.description
5,000 バイト video
snippet.tags
500 文字。プロパティ値はリストなので、リスト内の項目を区切るカンマは制限に対してカウントされます。 -
channel
リソースのbrandingSettings.watch.featuredPlaylistId
プロパティは非推奨になりました。値を設定しようとすると、API からエラーが返されます。 -
エラー ドキュメントに、各エラータイプの HTTP レスポンス コードが記載されるようになりました。
-
API で次のエラーがサポートされるようになりました。
エラーのタイプ エラーの詳細 説明 badRequest (400)
invalidCriteria
リクエストで、相互に使用できないフィルタ パラメータが指定されている場合、 channels.list
メソッドはこのエラーを返します。badRequest (400)
channelTitleUpdateForbidden
チャンネルの brandingSettings
部分を更新してbrandingSettings.channel.title
プロパティの値を変更しようとすると、channels.update
メソッドがこのエラーを返します。(プロパティを省略した場合、API はエラーを返しません)。badRequest (400)
invalidRecentlyUploadedBy
invideoPromotion.items[].id.recentlyUploadedBy
プロパティに無効なチャンネル ID が指定されている場合、channels.update
メソッドはこのエラーを返します。badRequest (400)
invalidTimingOffset
invideoPromotion
部分が無効なタイミング オフセットを指定している場合、channels.update
メソッドがこのエラーを返します。badRequest (400)
tooManyPromotedItems
invideoPromotion
部分で許可されているプロモート アイテムの数を超える数を指定すると、channels.update
メソッドはこのエラーを返します。forbidden (403)
promotedVideoNotAllowed
invideoPromotion.items[].id.videoId
プロパティに、見つからない動画 ID またはプロモーション対象アイテムとして使用できない動画 ID が指定されている場合、channels.update
メソッドはこのエラーを返します。forbidden (403)
websiteLinkNotAllowed
invideoPromotion.items[].id.websiteUrl
プロパティに許可されていない URL が指定されている場合、channels.update
メソッドはこのエラーを返します。required (400)
requiredTimingType
リクエストで、YouTube がプロモーション対象アイテムを表示するタイミングのデフォルトの設定が指定されていない場合、 channels.update
メソッドはこのエラーを返します。required (400)
requiredTiming
channels.update
メソッドでは、プロモーション対象アイテムごとにinvideoPromotion.items[].timing
オブジェクトを指定する必要があります。required (400)
requiredWebsiteUrl
channels.update
メソッドでは、プロモートされたアイテムごとにinvideoPromotion.items[].id.websiteUrl
プロパティを指定する必要があります。badRequest (400)
invalidPublishAt
リクエスト メタデータで無効なスケジュール設定された公開時間が指定されている場合、 videos.insert
メソッドはこのエラーを返します。
2014 年 3 月 4 日
この改訂での変更内容は次のとおりです:
-
YouTube Data API v3 には、YouTube API の利用規約に記載されている非推奨ポリシーが適用されるようになりました。なお、非推奨ポリシーの対象となる API の一覧では、v3 API の一部の機能がポリシーの適用対象外となっていますのでご注意ください。
2013 年 12 月 5 日
この改訂での変更内容は次のとおりです:
-
検索リクエストを送信する際に、フィルタ パラメータに 1 つだけ値を指定する必要がないことを適切に反映するように、
search.list
メソッドのドキュメントが更新されました。代わりに、0 個または 1 個のフィルタ パラメータに値を設定できます。 -
search.list
メソッドのパラメータの定義が更新され、次のいずれかのパラメータにも値を指定する場合は、type
パラメータの値をvideo
に設定する必要があります。eventType
videoCaption
videoCategoryId
videoDefinition
videoDimension
videoDuration
videoEmbeddable
videoLicense
videoSyndicated
videoType
-
アップロードできるチャンネル バナー画像の最小サイズは 2,048 ピクセル x 1,152 ピクセルに縮小されました。(これまでの最小サイズは 2120 x 1192 ピクセルでした)。また、
channel
リソースのドキュメントには、API から配信されるすべてのバナー画像の最大サイズが指定されています。たとえば、テレビ アプリケーションのbrandingSettings.image.bannerTvImageUrl
画像の最大サイズは 2,120 x 1,192 ピクセルですが、実際の画像は 2,048 x 1,152 ピクセルになる場合があります。さまざまな種類のデバイスでの表示に適したチャンネル アートを作成するためのガイダンスについては、YouTube ヘルプセンターをご覧ください。 -
次の情報を反映するように、いくつかの
channel
リソース プロパティの定義が更新されました。brandingSettings.channel.description
プロパティの値の最大長は 1,000 文字です。brandingSettings.channel.featuredChannelsTitle
プロパティの最大長は 30 文字です。brandingSettings.channel.featuredChannelsUrls[]
プロパティで最大 100 個のチャンネルを一覧表示できるようになりました。brandingSettings.channel.unsubscribedTrailer
プロパティ値を設定する場合は、チャンネル所有者が所有する公開動画または限定公開動画の YouTube 動画 ID を指定する必要があります。
-
channels.update
メソッドでinvideoPromotion.items[].promotedByContentOwner
プロパティの更新がサポートされるようになりました。このプロパティは、プロモーションを表示する際にコンテンツ所有者の名前を表示するかどうかを示します。このプロパティを設定できるのは、プロパティ値を設定する API リクエストが、コンテンツ所有者の代わりにonBehalfOfContentOwner
パラメータを使用して行われた場合に限られます。 -
playlistItems.list
メソッドとplaylistItems.insert
メソッドでonBehalfOfContentOwner
パラメータがサポートされるようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。 -
contentDetails.contentRating.acbRating
プロパティで、映画の場合はオーストラリア分類委員会(ACB)、子供向けテレビ番組の場合はオーストラリア通信メディア局(ACMA)のレーティングを指定できるようになりました。 -
新しい
contentDetails.contentRating.catvRating
プロパティとcontentDetails.contentRating.catvfrRating
プロパティは、カナダのテレビ分類システムと、ケベックで使用されているフランス語の Régie du cinéma レーティング システムで動画に割り当てられたレーティングをそれぞれ識別します。 -
videoCategory
リソースの新しいsnippet.assignable
プロパティは、更新された動画または新しくアップロードされた動画をその動画カテゴリに関連付けることができるかどうかを示します。 -
次のメソッドのコードサンプルが追加されました。
activities.insert
(Go)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(Go)search.list
(Go)thumbnails.set
(Java)videos.insert
(Go)
2013 年 10 月 24 日
この改訂での変更内容は次のとおりです:
-
この API には、ライブ配信コンテンツの検索と特集に役立つ次の 2 つの機能が追加されています。
検索結果に表示される新しい
snippet.liveBroadcastContent
プロパティは、動画リソースまたはチャンネル リソースにライブ配信コンテンツが含まれているかどうかを示します。有効なプロパティ値はupcoming
、active
、none
です。-
video
リソースの新しいsnippet.liveBroadcastContent
プロパティは、動画が今後のライブ配信かアクティブなライブ配信かを示します。プロパティの有効な値は次のとおりです。upcoming
- 動画は、まだ開始されていないライブ放送です。active
– 動画は進行中のライブ配信です。none
– 動画が今後予定されている、またはアクティブなライブ配信ではありません。これは、YouTube で引き続き視聴可能な、完了済みのブロードキャストのプロパティ値です。
-
video
リソースの新しいliveStreamingDetails
プロパティは、ライブ動画ブロードキャストに関するメタデータを含むオブジェクトです。このメタデータを取得するには、part
パラメータ値のリソース パートのリストにliveStreamingDetails
を含めます。メタデータには、次の新しいプロパティが含まれています。liveStreamingDetails.actualStartTime
– ブロードキャストが実際に開始された時刻。(この値は、ブロードキャストの状態がactive
になると存在します)。liveStreamingDetails.actualEndTime
– ブロードキャストが実際に終了した時刻。(この値はブロードキャストが終了すると表示されます)。liveStreamingDetails.scheduledStartTime
– ブロードキャストの開始時間。liveStreamingDetails.scheduledEndTime
– ブロードキャストの終了が予定されている時刻。プロパティ値が空の場合、またはプロパティが存在しない場合、ブロードキャストは無期限に継続するようにスケジュール設定されます。liveStreamingDetails.concurrentViewers
- ライブ配信を視聴している視聴者数。
このメタデータを取得するには、
videos.list
、videos.insert
、またはvideos.update
メソッドを呼び出すときに、part
パラメータ値にliveStreamingDetails
を含めます。
なお、ライブ配信コンテンツを識別するための他の 2 つの機能(
search.list
メソッドのeventType
パラメータと検索結果のsnippet.liveBroadcastContent
プロパティ)が 2013 年 10 月 1 日にリリースされました。 -
-
videos.insert
メソッドでnotifySubscribers
パラメータがサポートされるようになりました。このパラメータは、動画のチャンネルに登録するユーザーに新しい動画に関する通知を送信するかどうかを示すものです。このパラメータのデフォルト値はTrue
です。この場合、新しく動画がアップロードされたことがチャンネル登録者に通知されます。ただし、多くの動画をアップロードしているチャンネル所有者は、新しい動画ごとにチャンネル登録者に通知が送信されないように、値をFalse
に設定することをおすすめします。 -
channels.update
メソッドの呼び出し時に変更できるプロパティのリストが更新され、invideoPromotion.items[].customMessage
プロパティとinvideoPromotion.items[].websiteUrl
プロパティが追加されました。また、変更可能なbrandingSettings
プロパティを識別するようにリストが変更されました。これらのbrandingSettings
プロパティはすでに変更可能であるため、このドキュメントの変更には API の既存の機能に対する変更は反映されません。 -
playlists.insert
、playlists.update
、playlists.delete
の各メソッドでonBehalfOfContentOwner
パラメータがサポートされるようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。 -
playlists.insert
メソッドでonBehalfOfContentOwnerChannel
パラメータがサポートされるようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。 -
video
リソースのcontentDetails.contentRating.tvpgRating
プロパティが、TV-14
評価に対応するpg14
の値をサポートするようになりました。 -
検索結果の一部である
snippet.liveBroadcastContent
プロパティの定義を修正し、live
は有効なプロパティ値であるが、active
は有効なプロパティ値ではないことを反映しました。 -
video
リソースのcontentDetails.contentRating.mibacRating
プロパティで、次の 2 つのレーティングがサポートされるようになりました。mibacVap
(VAP)– お子様は大人の同伴が必要です。mibacVm6
(V.M.6)- 6 歳以上のみ可。mibacVm12
(V.M.12)- 12 歳以上のみ可。
-
channel
リソースの新しいinvideoPromotion.items[].promotedByContentOwner
プロパティは、プロモーションを表示する際にコンテンツ所有者の名前を表示するかどうかを示します。このフィールドを設定できるのは、値を設定する API リクエストがコンテンツ所有者の代理として行われた場合に限られます。詳細については、onBehalfOfContentOwner
パラメータをご覧ください。
2013 年 10 月 1 日
この改訂での変更内容は次のとおりです:
-
channel
リソースの新しいauditDetails
オブジェクトには、マルチチャンネル ネットワーク(MCN)が特定のチャンネルを承認するか拒否するかを判断する際に評価されるチャンネル データが含まれます。このリソース部分を取得する API リクエストでは、https://www.googleapis.com/auth/youtubepartner-channel-audit
スコープを含む認証トークンを指定する必要があります。また、そのスコープを使用するトークンは、MCN がチャンネルの承認または拒否を決定したとき、またはトークンが発行された日から 2 週間以内に取り消す必要があります。 -
channel
リソースのinvideoPromotion.items[].id.type
プロパティがrecentUpload
の値をサポートするようになりました。この値は、プロモート アイテムが、指定されたチャンネルから最近アップロードされた動画であることを示します。デフォルトでは、このチャンネルは、動画内プロモーション データが設定されているチャンネルと同じになります。ただし、新しい
invideoPromotion.items[].id.recentlyUploadedBy
プロパティの値をそのチャンネルのチャンネル ID に設定することで、他のチャンネルで最近アップロードされた動画を宣伝できます。 -
channel
リソースには、テレビ アプリのチャンネル ページに表示されるバナー画像の URL を指定する 3 つの新しいプロパティ(brandingSettings.image.bannerTvLowImageUrl
、brandingSettings.image.bannerTvMediumImageUrl
、brandingSettings.image.bannerTvHighImageUrl
)が含まれています。 -
検索結果に表示される新しい
snippet.liveBroadcastContent
プロパティは、動画リソースまたはチャンネル リソースにライブ配信コンテンツが含まれているかどうかを示します。有効なプロパティ値はupcoming
、active
、none
です。video
リソースの場合、upcoming
の値は動画がまだ開始されていないライブ配信であることを示し、値active
は動画が進行中のライブ配信であることを示します。channel
リソースの場合、値upcoming
は、チャンネルにまだ開始されていないスケジュール設定されたブロードキャストがあることを示します。値acive
は、チャンネルでライブ配信が進行中であることを示します。
-
watermark
リソースで、targetChannelId
プロパティがオブジェクトから文字列に変更されました。透かし画像がリンクするチャンネルの YouTube チャンネル ID を指定する子プロパティではなく、targetChannelId
プロパティがその値自体を指定するようになりました。これに伴い、リソースのtargetChannelId.value
プロパティは削除されました。 -
thumbnails.set
メソッドがonBehalfOfContentOwner
パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。 -
search.list
メソッドでeventType
パラメータがサポートされるようになりました。これにより、アクティブなブロードキャスト イベント、今後のブロードキャスト イベント、完了したブロードキャスト イベントのみを返すように検索を制限できます。 -
新しい
contentDetails.contentRating.mibacRating
プロパティは、イタリアの Ministero dei Beni e delle Attivita Culturali e del Turismo から動画に付与されたレーティングを識別します。 -
この API は、次のエラーをサポートするようになりました。
エラーのタイプ エラーの詳細 説明 badRequest
invalidImage
指定された画像コンテンツが無効な場合、 thumbnails.set
メソッドはこのエラーを返します。forbidden
videoRatingDisabled
評価対象の動画の所有者が動画の評価を無効にしている場合、 videos.rate
メソッドはこのエラーを返します。
2013 年 8 月 27 日
この改訂での変更内容は次のとおりです:
-
新しい
watermark
リソースは、指定したチャンネルの動画の再生中に表示される画像を識別します。画像のリンク先ターゲット チャンネルや、動画の再生中に透かしを表示するタイミングとその長さを指定することもできます。watermarks.set
メソッドは、チャンネルの透かし画像をアップロードして設定します。watermarks.unset
メソッドは、チャンネルのウォーターマーク画像を削除します。エラー ドキュメントでは、特に
watermarks.set
メソッドとwatermarks.unset
メソッド向けに API がサポートするエラー メッセージについて説明します。 -
channel
リソースの新しいstatistics.hiddenSubscriberCount
プロパティには、チャンネル登録者数が非表示かどうかを示すブール値が含まれます。そのため、チャンネルのチャンネル登録者数が一般公開されている場合、プロパティの値はfalse
になります。 -
playlists.list
メソッドがonBehalfOfContentOwner
パラメータとonBehalfOfContentOwnerChannel
パラメータをサポートするようになりました。どちらのパラメータも、他のいくつかのメソッドですでにサポートされています。 -
videos.list
メソッドがregionCode
パラメータをサポートするようになりました。このパラメータは、グラフを取得するコンテンツ領域を識別します。このパラメータは、chart
パラメータと組み合わせて使用する必要があります。このパラメータの値は ISO 3166-1 alpha-2 の国コードです。 -
error documentation
は、複数の API メソッドで発生する可能性のある、次の新しい一般的なリクエスト エラーを記述します。エラーのタイプ エラーの詳細 説明 forbidden
insufficientPermissions
リクエストに指定された OAuth 2.0 トークンに関連付けられているスコープが、リクエストされたデータにアクセスするのに不十分です。
2013 年 8 月 15 日
この改訂での変更内容は次のとおりです:
-
channel
リソースのinvideoPromotion
オブジェクトには、次の新しいプロパティと更新されたプロパティがあります。-
API で、ウェブサイトをプロモート アイテムとして指定できるようになりました。これを行うには、
invideoPromotion.items[].id.type
プロパティの値をwebsite
に設定し、新しいinvideoPromotion.items[].id.websiteUrl
プロパティを使用して URL を指定します。また、新しいinvideoPromotion.items[].customMessage
プロパティを使用して、プロモーションに表示するカスタム メッセージを定義します。関連ウェブサイト、販売者サイト、ソーシャル ネットワーク サイトなどへのリンクを指定できます。コンテンツのリンクを有効にする方法について詳しくは、関連するウェブサイトと販売者のサイトに関する YouTube ヘルプセンターの手順をご覧ください。
プロモーション リンクを追加すると、それらのリンクが未承認のサイトへのトラフィックのリダイレクトに使用されないこと、およびそれらのリンクが YouTube の広告ポリシー、YouTube 広告ポリシー、YouTube コミュニティ ガイドライン、YouTube 利用規約に準拠していることに同意したものとみなされます。
-
動画の再生中にプロモート アイテムを表示するタイミング設定に関連するプロパティが再構成されました。
-
invideoPromotion.timing
オブジェクトはinvideoPromotion.items[].timing
に移動されました。このオブジェクトを使用すると、invideoPromotion.items[]
リスト内のプロモートされた各アイテムのタイミング データをカスタマイズできるようになりました。 -
新しい
invideoPromotion.defaultTiming
オブジェクトでは、プロモーションのデフォルトのタイミング設定を指定します。これらの設定では、チャンネルの動画を再生中にプロモート アイテムを表示するタイミングを定義します。invideoPromotion.items[].timing
オブジェクトを使用すると、特定のプロモート アイテムのデフォルトのタイミングをオーバーライドできます。 -
新しい
invideoPromotion.items[].timing.durationMs
プロパティは、プロモーションを表示する時間をミリ秒単位で指定します。invideoPromotion.defaultTiming
オブジェクトには、プロモーション対象アイテムを表示するデフォルトの時間を指定するdurationMs
フィールドも含まれています。
-
-
invideoPromotion.items[].type
プロパティとinvideoPromotion.items[].videoId
プロパティの両方をinvideoPromotion.items[].id
オブジェクトに移動しました。
-
-
subscriptions.list
メソッドがonBehalfOfContentOwner
パラメータとonBehalfOfContentOwnerChannel
パラメータをサポートするようになりました。どちらのパラメータも、他のいくつかのメソッドですでにサポートされています。 -
thumbnails.set
リクエストに対する API レスポンスで、kind
プロパティの値がyoutube#thumbnailListResponse
からyoutube#thumbnailSetResponse
に変更されています。 -
次のメソッドのコードサンプルが追加されました。
channels.update
(Java、Python)playlists.insert
(.NET、PHP)subscriptions.insert
(PHP、Python)thumbnails.set
(PHP、Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java、PHP、Python)
なお、
playlistItems.insert
メソッドの Python の例も、ここで示した機能がvideos.rate
メソッドで処理されるため削除されました。 -
error documentation
は、mine
リクエスト パラメータをサポートする任意の API メソッドで発生する可能性のある、次の新しいリクエスト コンテキスト エラーを表します。エラーのタイプ エラーの詳細 説明 badRequest
invalidMine
mine
パラメータは、認証されたユーザーが YouTube パートナーであるリクエストでは使用できません。mine
パラメータを削除するか、onBehalfOfContentOwner
パラメータを削除して YouTube ユーザーとして認証するか、呼び出されたメソッドで使用可能な場合はonBehalfOfContentOwnerChannel
パラメータを指定してパートナーのチャンネルのいずれかとして動作する必要があります。
2013 年 8 月 8 日
この改訂での変更内容は次のとおりです:
-
YouTube Data API スタートガイドの「割り当ての使用」セクションが更新され、動画のアップロードの割り当てコストが約 16,000 ユニットから約 1,600 ユニットに変更されています。
2013 年 7 月 30 日
この改訂での変更内容は次のとおりです:
-
channelBanner
リソースで、kind
プロパティの値がyoutube#channelBannerInsertResponse
からyoutube#channelBannerResource
に変更されました。このリソースは、channelBanners.insert
リクエストに応答して返されます。 -
channel
リソースの新しいbrandingSettings.channel.profileColor
プロパティは、チャンネルのコンテンツを引き立たせる目立つ色を指定します。プロパティ値は、番号記号(#
)に続いて 6 文字の 16 進数文字列(#2793e6
など)です。 -
API で、チャンネルのすべてのアクティビティを登録対象とするのか、新規アップロードのみを登録対象とするのかを指定できるようになりました。
subscription
リソースの新しいcontentDetails.activityType
プロパティは、サブスクライバーに通知されるアクティビティのタイプを識別します。有効なプロパティ値はall
とuploads
です。 -
videos.list
メソッドは、YouTube で最も人気のある動画のチャートを取得するための新しいパラメータをサポートしています。chart
パラメータは、取得するグラフを識別します。現在サポートされている値はmostPopular
のみです。chart
パラメータはフィルタ パラメータであるため、他のフィルタ パラメータ(id
とmyRating
)と同じリクエストで使用できません。videoCategoryId
パラメータは、グラフを取得する動画カテゴリを指定します。このパラメータは、chart
パラメータと組み合わせて使用できます。デフォルトでは、グラフは特定のカテゴリに制限されません。
-
video
リソースの新しいtopicDetails.relevantTopicIds[]
プロパティは、動画またはそのコンテンツに関連する Freebase トピック ID のリストを提供します。これらのトピックのテーマは、動画で言及されていたり、動画に登場したりする可能性があります。 -
video
リソースのrecordingDetails.location.elevation
プロパティの名前がrecordingDetails.location.altitude
に変更され、fileDetails.recordingLocation.location.elevation
プロパティの名前がfileDetails.recordingLocation.location.altitude
に変更されました。 -
video
リソースのcontentDetails.contentRating
オブジェクトには、MPAA レーティング、TVPG レーティングなど、さまざまなレーティング スキームで動画に付与されたレーティングを指定します。各レーティング システムについて、動画にレーティングが設定されていないことを示すレーティング値が API でサポートされるようになりました。MPAA レーティングでは、カット版の映画が公式のレーティングを受けている場合、カットされていないバージョンの映画を識別するために「未レーティング」のレーティングがよく使用されます。 -
video
リソースの新しいcontentDetails.contentRating.ytRating
プロパティは、年齢制限のあるコンテンツを識別します。YouTube が 18 歳未満のユーザーにとって不適切なコンテンツが含まれていると判断した場合、プロパティ値はytAgeRestricted
になります。プロパティが存在しない場合、またはプロパティ値が空の場合、コンテンツに年齢制限は設定されていません。 -
channels.list
メソッドのmySubscribers
パラメータのサポートが終了しました。subscriptions.list
メソッドとそのmySubscribers
パラメータを使用して、認証されたユーザーのチャンネルの登録者のリストを取得します。 -
channelBanners.insert
、channels.update
、videos.getRating
、videos.rate
の各メソッドがonBehalfOfContentOwner
パラメータをサポートするようになりました。このパラメータは、認証済みユーザーがパラメータ値で指定されたコンテンツ所有者の代理で行動していることを示します。 -
channels.update
メソッドのドキュメントが更新され、このメソッドを使用してchannel
リソースのbrandingSettings
オブジェクトとその子プロパティを更新できるという事実が反映されました。また、channel
リソースのinvideoPromotion
オブジェクトに設定できるプロパティの更新されたリストもドキュメントに記載されています。 -
error documentation
は、次の新しいエラーを示します。エラーのタイプ エラーの詳細 説明 forbidden
accountDelegationForbidden
このエラーは特定の API メソッドに固有のものではありません。これは、認証されたユーザーが指定された Google アカウントの代理として動作する権限を持っていないことを示します。 forbidden
authenticatedUserAccountClosed
このエラーは、特定の API メソッドに固有のものではありません。認証されたユーザーの YouTube アカウントが閉鎖されていることを示します。お客様が別の Google アカウントの代理で操作している場合は、そのアカウントが閉鎖されていることを示します。 forbidden
authenticatedUserAccountSuspended
このエラーは、特定の API メソッドに固有のものではありません。これは、認証されたユーザーの YouTube アカウントが停止されていることを示します。ユーザーが別の Google アカウントの代理として操作を行っている場合、このエラーは他のアカウントが停止されていることを示しています。 forbidden
authenticatedUserNotChannel
このエラーは、特定の API メソッドに固有のものではありません。これは、API サーバーが API リクエストに関連付けられたチャネルを識別できないことを示します。リクエストが承認され、 onBehalfOfContentOwner
パラメータを使用している場合は、onBehalfOfContentOwnerChannel
パラメータも設定する必要があります。forbidden
cmsUserAccountNotFound
このエラーは特定の API メソッドに固有のものではありません。その CMS ユーザーは、指定されたコンテンツの所有者に代わって操作を実行することを許可されていません。 notFound
contentOwnerAccountNotFound
このエラーは、特定の API メソッドに固有のものではありません。指定されたコンテンツの所有者アカウントが見つかりませんでした。 badRequest
invalidPart
このエラーは特定の API メソッドに固有のものではありません。リクエストの part
パラメータは、同時に書き込めないパーツを指定しています。badRequest
videoChartNotFound
サポートされていない、または利用できない動画グラフがリクエストで指定された場合、 videos.list
メソッドはこのエラーを返します。notFound
videoNotFound
videos.update
メソッドは、更新しようとしている動画が見つからなかったことを示すエラーを返します。リクエスト本文のid
プロパティの値が正しいことを確認します。
2013 年 6 月 10 日
この改訂での変更内容は次のとおりです:
-
channels.list
メソッドの新しいforUsername
パラメータを使用すると、YouTube ユーザー名を指定してチャンネルに関する情報を取得できます。 -
activities.list
メソッドでregionCode
パラメータがサポートされるようになりました。このパラメータは、指定された国に関連する結果を返すよう API に指示します。承認されたユーザーがこれまでに YouTube で行ったアクティビティでは、アクティビティ フィードを生成するのに不十分な場合、YouTube はこの値を使用します。 -
再生リスト リソースに
snippet.tags
プロパティが追加されました。このプロパティは、自分の再生リストに関するデータを取得している承認済みユーザーにのみ返されます。承認されたユーザーは、playlists.insert
メソッドまたはplaylists.update
メソッドを呼び出すときに再生リストのタグを設定することもできます。 -
これまで
channels.list
メソッドとsearch.list
メソッドでサポートされていたonBehalfOfContentOwner
パラメータが、videos.insert
、videos.update
、videos.delete
メソッドでもサポートされるようになりました。このパラメータをvideos.insert
メソッドの呼び出しで使用する場合、リクエストでは新しいonBehalfOfContentOwnerChannel
パラメータの値も指定する必要があります。これにより、動画が追加されるチャンネルを識別できます。チャンネルは、onBehalfOfContentOwner
パラメータで指定されたコンテンツ所有者にリンクされている必要があります。このパラメータは、リクエストの認証情報で、パラメータ値で指定されたコンテンツ所有者の代理として行動する YouTube CMS ユーザーが識別されることを示します。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。
このパラメータは、さまざまな YouTube チャンネルを所有して管理しているコンテンツ パートナーを対象としています。このパラメータを使用すると、パートナーは一度認証を行うだけで、個々のチャンネルの認証情報を提供することなく、すべての動画とチャンネルのデータにアクセスできます。
具体的には、このパラメータにより、コンテンツ パートナーが所有するすべての YouTube チャンネルで動画を挿入、更新、削除できるようになりました。
-
error documentation
には、次の新しいエラーが記述されています。エラーのタイプ エラーの詳細 説明 forbidden
insufficientCapabilities
このエラーは特定の API メソッドに固有のものではありません。これは、API を呼び出す CMS ユーザーに、リクエストされた操作を実行するのに十分な権限がないことを示しています。このエラーは、複数の API メソッドでサポートされている onBehalfOfContentOwner
パラメータの使用に関連しています。unauthorized
authorizationRequired
リクエストで home
パラメータが使用されているにもかかわらず、適切に承認されていない場合、activities.list
メソッドはこのエラーを返します。 -
channels
リソースでは、チャンネル ID がリソースのid
プロパティですでに指定されているため、invideoPromotion.channelId
プロパティが削除されました。 -
新しいチャンネル ID の使用ガイドでは、API でチャンネル ID がどのように使用されるかについて説明しています。このガイドは、以前のバージョンの API から移行し、
default
ユーザーのコンテンツをリクエストするアプリケーションや、すべての YouTube チャンネルに一意のユーザー名があり、現在はそうではないアプリケーションを使用しているデベロッパーに特に役立ちます。
2013 年 5 月 22 日
この改訂での変更内容は次のとおりです:
-
新しい
channelBanners.insert
メソッドを使用すると、バナー画像をアップロードして、channel
リソースの新しいbrandingSettings.image.bannerExternalUrl
プロパティを使用してチャンネルのバナー画像として設定できます。 -
channels.update
メソッドのドキュメントを更新し、メソッドの呼び出し時に変更できるプロパティを一覧表示しました。 -
video
リソースのドキュメントで、suggestions.processingErrors[]
、suggestions.processingHints[]
、suggestions.processingWarnings[]
、suggestions.editorSuggestions[]
プロパティの有効なプロパティ値としてunspecified
が記載されなくなりました。 -
videos.list
メソッドのmaxResults
パラメータのデフォルト値が5
になりました。 -
error documentation
は、channelBanners.insert
メソッドとsubscriptions.list
メソッドのエラーをリストするようになりました。また、channels.update
メソッドの新しいエラーもいくつかリストされています。
2013 年 5 月 14 日
この改訂での変更内容は次のとおりです:
-
Python コードサンプルの一覧ページに、チャンネル登録の追加、再生リストの作成、動画の更新の例が追加されました。
2013 年 5 月 10 日
この改訂での変更内容は次のとおりです。
-
YouTube では、試験的な API の機能とサービスを識別しなくなりました。代わりに、サポート終了予定ポリシーの対象となる YouTube API のリストを提供しています。
2013 年 5 月 8 日
この改訂での変更内容は次のとおりです:
-
チャンネル リソースで
inVideoPromotion
オブジェクトがサポートされるようになりました。このオブジェクトは、チャンネルに関連付けられたプロモーション キャンペーンに関する情報をカプセル化します。動画内プロモーション キャンペーンを利用すると、チャンネルの動画の再生中に、動画プレーヤー内にプロモート動画のサムネイル画像を表示できます。このデータを取得するには、
channels.list
リクエストのpart
パラメータ値にinvideoPromotion
を含めます。 -
新しい
channels.update
メソッドを使用すると、チャンネルの動画内プロモーション キャンペーンのデータを更新できます。このメソッドは、channel
リソースのinvideoPromotion
部分の更新のみをサポートし、そのリソースの他の部分の更新はまだサポートしていません。
2013 年 5 月 2 日
この改訂での変更内容は次のとおりです:
-
チャンネル リソースで
status.isLinked
プロパティがサポートされるようになりました。このプロパティは、チャンネルデータで YouTube ユーザー名または Google+ アカウントにすでにリンクされているユーザーが識別されているかどうかを示します。このいずれかのリンクを持つユーザーは公開されている YouTube ID を既に持っているユーザーであり、動画のアップロードなど、いくつかの操作の前提条件となります。 -
サブスクリプション リソースが
subscriberSnippet
部分をサポートするようになりました。このオブジェクトには、チャンネル登録者のチャンネルのスニペット データがカプセル化されています。 -
この API は、
videos.getRating
メソッドをサポートするようになりました。このメソッドは、認証済みユーザーが 1 つ以上の動画のリストに付けた評価を取得します。 -
videos.list
メソッドの新しいmyRating
パラメータを使用すると、認証済みユーザーがlike
またはdislike
の評価を付けた動画のリストを取得できます。myRating
パラメータとid
パラメータはどちらもフィルタ パラメータと見なされるようになりました。つまり、API リクエストではパラメータのうち 1 つのみを指定する必要があります。(以前は、このメソッドにid
パラメータが必須パラメータでした)。このメソッドは、動画の評価情報を取得しようとしているが、適切に承認されていないリクエストに対して
forbidden
エラーを返します。 -
myRating
パラメータの導入に伴い、videos.list
メソッドも更新され、ページネーションをサポートするようになりました。ただし、ページング パラメータは、myRating
パラメータを使用するリクエストでのみサポートされます。(ページング パラメータと情報は、id
パラメータを使用するリクエストではサポートされていません)。-
maxResults
パラメータは、API が結果セットで返すことができる動画の最大数を指定します。pageToken
パラメータは、取得する結果セット内の特定のページを指定します。 -
videos.list
リクエストのレスポンスとして返されるyoutube#videoListResponse
リソースに、pageInfo
オブジェクトが追加されました。このオブジェクトには、結果の合計数や現在の結果セットに含まれる結果の数などの詳細が含まれています。youtube#videoListResponse
リソースには、nextPageToken
プロパティとprevPageToken
プロパティを含めることもできます。各プロパティは、結果セットの特定のページを取得するために使用できるトークンを提供します。
-
-
videos.insert
メソッドは、次の新しいパラメータをサポートしています。autoLevels
– このパラメータ値をtrue
に設定すると、動画の明るさと色の補正が自動的に行われます。stabilize
– このパラメータ値をtrue
に設定すると、カメラの動きによるぶれを除去して動画を調整できます。
-
次のリソースの
snippet
にchannelTitle
プロパティが追加されました。playlistItem
- このプロパティには、再生リストのアイテムを追加したチャンネルの名前を指定します。playlist
– このプロパティは、再生リストを作成したチャンネルの名前を指定します。subscription
- このプロパティには、定期購入しているチャンネルの名前を指定します。
-
次のメソッドのコードサンプルが追加されました。
activities.insert
(Ruby)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java、Ruby)videos.insert
(.NET、Ruby)
-
subscriptions.list
メソッドの新しいmySubscribers
パラメータを使用すると、現在認証されているユーザーのチャンネル登録者のリストを取得できます。このパラメータは、適切に承認されたリクエストでのみ使用できます。注: この機能は、現在
channels.list
メソッドでサポートされているmySubscribers
パラメータに代わるものです。このパラメータのサポートは終了する予定です。 -
video
リソースでは、プロパティ値unspecified
が次のいずれかのプロパティの値ではなくなりました。 -
予期しないパラメータを含む API リクエストで
badRequest
エラーが返されるようになりました。報告されたエラーの理由はunexpectedParameter
です。 -
再生リストに許可されているアイテムの最大数をすでに含んでいる場合に
playlistItems.insert
メソッドが返すエラーが更新されました。エラーはforbidden
エラーとして報告され、エラーの理由はplaylistContainsMaximumNumberOfVideos
になります。
2013 年 4 月 19 日
この改訂での変更内容は次のとおりです:
-
新しい
videos.rate
メソッドを使用すると、ユーザーは動画にlike
またはdislike
の評価を設定したり、動画から評価を削除したりできます。エラー ドキュメントも更新され、
videos.rate
メソッド呼び出しへのレスポンスとして API から返される可能性のあるエラーの一覧が表示されています。 -
サムネイル画像が API ドキュメントで個別のリソースとして識別されるようになりました。また、新しい
thumbnails.set
メソッドを使用すると、カスタムの動画サムネイルを YouTube にアップロードして動画に設定できるようになりました。エラー ドキュメントも更新され、
thumbnails.set
メソッド呼び出しへのレスポンスとして API から返される可能性のあるエラーの一覧が表示されています。この変更は、サムネイル画像を返す既存のリソースにはあまり影響しません。サムネイル画像は以前と同じ方法でリソースに返されますが、ドキュメントには API から返される可能性のあるさまざまなサムネイル サイズの名前が記載されるようになりました。
-
channel
リソースの新しいbrandingSettings
部分には、チャンネルのチャンネル ページと動画再生ページの設定、テキスト、画像を指定します。 -
playlistItem
リソースには、次の新しいプロパティが含まれています。-
新しい
status
オブジェクトは再生リスト アイテムのステータス情報をカプセル化し、status.privacyStatus
プロパティは再生リスト アイテムのプライバシー ステータスを識別します。
-
-
video
リソースには、次の新しいプロパティが含まれています。-
status.publicStatsViewable
プロパティは、動画再生ページの拡張動画統計情報が一般公開されるかどうかを示します。デフォルトでは、これらの統計情報は閲覧可能です。このプロパティの値がfalse
に設定されている場合でも、動画の再生回数や評価などは一般公開されます。このプロパティの値は、videos.insert
メソッドまたはvideos.update
メソッドを呼び出すときに設定できます。 -
contentDetails.contentRating
オブジェクトは、さまざまなレーティング スキームで動画に付与されたレーティングをカプセル化します。以下のリストでは、サポートされているレーティング システムを特定し、各レーティング システムに関連付けられている宿泊施設へのリンクを示します。プロパティの定義では、各システムでサポートされているレーティング値を指定します。
-
-
playlistItems.update
メソッドのドキュメントが更新され、リクエスト本文として送信されるリソースにsnippet.resourceId
プロパティを指定する必要があることが反映されました。 -
search.list
メソッドで次の機能がサポートされるようになりました。-
新しい
forMine
パラメータを使用すると、認証されたユーザーの動画のみを取得するように検索を制限できます。 -
order
パラメータで、結果をタイトルのアルファベット順(order=title
)または動画数の降順(order=videoCount
)で並べ替えることができるようになりました。 -
新しい
safeSearch
パラメータは、制限付きコンテンツを検索結果に含めるかどうかを示します。
-
-
videos.insert
メソッドは、次の表に示すいくつかの新しいエラーをサポートしています。エラーのタイプ エラーの詳細 説明 badRequest
invalidCategoryId
snippet.categoryId
プロパティに無効なカテゴリ ID が指定されています。videoCategories.list
メソッドを使用して、サポートされているカテゴリを取得します。badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
リクエスト メタデータで指定されたビデオ ゲームの評価は無効です。 badRequest
invalidVideoMetadata
リクエスト メタデータが無効です。 -
onBehalfOfContentOwner
パラメータが、videos.update
メソッドとvideos.delete
メソッドでサポートされているパラメータのリストから削除されました。
2013 年 3 月 12 日
この改訂での変更内容は次のとおりです:
-
次のリソースの
snippet
にchannelTitle
プロパティが追加されました。 -
search.list
メソッドは、次の新しいパラメータをサポートしています。-
channelType
パラメータを使用すると、チャンネルの検索を制限して、すべてのチャンネルを取得することも、番組のみを取得することもできます。 -
videoType
パラメータを使用すると、動画の検索を制限して、すべての動画を取得するか、映画のみまたは番組のエピソードのみ取得できます。
-
-
video
リソースのrecordingDetails
部分の定義が更新され、動画の位置情報データまたは録画時間が設定されている場合にのみ、動画に対してオブジェクトが返されることが明記されました。 -
API リクエストで有効なスニペットが指定されていない場合、
playlistItems.update
メソッドがinvalidSnippet
エラーを返すようになりました。 -
いくつかの API メソッドでは、YouTube コンテンツ パートナー専用の新しいパラメータがサポートされています。YouTube コンテンツ パートナーには、映画やテレビのスタジオ、レコード レーベル、YouTube でコンテンツを提供しているその他のコンテンツ クリエイターが含まれます。
-
onBehalfOfContentOwner
パラメータは、リクエストの認可認証情報で、パラメータ値で指定されたコンテンツ所有者の代理として行動する YouTube CMS ユーザーが識別されることを示します。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。このパラメータは、さまざまな YouTube チャンネルを所有、管理しているコンテンツ パートナーを対象としています。このパラメータを使用すると、パートナーはチャンネルごとに認証情報を提示しなくても、一度認証するだけですべての動画とチャンネルのデータにアクセスできます。
channels.list
、search.list
、videos.delete
、videos.list
、videos.update
の各メソッドはすべてこのパラメータをサポートしています。 -
managedByMe
パラメータはchannels.list
メソッドでサポートされているもので、onBehalfOfContentOwner
パラメータで指定されたコンテンツ所有者が所有するすべてのチャンネルを返すように API に指示します。 -
search.list
メソッドでサポートされているforContentOwner
パラメータは、onBehalfOfContentOwner
パラメータで指定されたコンテンツ所有者が所有するリソースのみを検索結果に含めるように API に指示します。
-
2013 年 2 月 25 日
この改訂での変更内容は次のとおりです:
-
API は、
video
リソース用に新しい部分とプロパティをいくつかサポートしています。-
新しい
fileDetails
、processingDetails
、suggestions
の各部分には、アップロードされた動画に関する情報が動画所有者に提供されます。このデータは、動画のアップロードを可能にするアプリで非常に役立ちます。次のようなデータが含まれます。- 処理ステータスと進行状況
- エラーなど、動画の処理中に発生した
- サムネイル画像の有無
- 動画やメタデータの品質を改善するための提案
- YouTube にアップロードされた元のファイルの詳細
これらの部分を取得できるのは、動画の所有者に限られます。以下のリストでは、新しいパーツを簡単に説明し、
video
リソースのドキュメントでは、各パーツに含まれるすべてのプロパティを定義しています。-
fileDetails
オブジェクトには、YouTube にアップロードされた動画ファイルに関する情報(ファイルの解像度、時間、音声コーデックと動画コーデック、ストリームのビットレートなど)が含まれます。 -
processingProgress
オブジェクトには、アップロードされた動画ファイルの処理に関する YouTube の進行状況に関する情報が含まれます。オブジェクトのプロパティには、現在の処理ステータスと、YouTube が動画の処理を完了するまでの残り時間が示されます。また、この部分は、ファイルの詳細やサムネイル画像など、さまざまなタイプのデータやコンテンツを動画で利用できるかどうかも示しています。このオブジェクトは、動画アップロード者がアップロードした動画ファイルの処理状況をトラッキングできるように、ポーリングするように設計されています。
-
suggestions
オブジェクトには、アップロードされた動画の動画品質やメタデータを改善できる機会を特定する候補が含まれます。
-
contentDetails
部分には、4 つの新しいプロパティが含まれています。これらのプロパティは、未認証のリクエストで取得できます。dimension
– 動画が 2D か 3D かを示します。definition
– 動画が標準画質と高画質のどちらで使用できるかを示します。caption
– 動画で字幕を利用できるかどうかを示します。licensedContent
– YouTube コンテンツ パートナーから申し立てを受けたコンテンツが動画に含まれているかどうかを示します。
-
status
部分には 2 つの新しいプロパティが含まれています。動画の所有者は、動画の挿入時または更新時に両方のプロパティに値を設定できます。これらのプロパティは、未認証のリクエストで取得することもできます。embeddable
- 動画を他のウェブサイトに埋め込めるかどうかを示します。license
- 動画のライセンスを指定します。有効な値はcreativeCommon
とyoutube
です。
-
-
part
パラメータの定義がvideos.list
、videos.insert
、videos.update
メソッドで更新され、上記で説明した新しく追加された部分と、誤って省略されていたrecordingDetails
部分が一覧表示されるようになります。 -
channel
リソースの新しいcontentDetails.googlePlusUserId
プロパティには、チャンネルに関連付けられた Google+ プロフィール ID を指定します。この値を使用して、Google+ プロフィールへのリンクを生成できます。 -
各サムネイル画像オブジェクトで画像の幅と高さを指定するようになりました。現在、サムネイル画像は
activity
、channel
、playlist
、playlistItem
、search result
、subscription
、video
リソースで返されます。 -
playlistItems.list
でvideoId
パラメータがサポートされるようになりました。このパラメータをplaylistId
パラメータと組み合わせて使用すると、指定した動画を表す再生リスト アイテムのみを取得できます。パラメータで指定された動画が再生リストに見つからない場合、API は
notFound
エラーを返します。 -
エラー ドキュメントに、リクエストされたアクションに対してリクエストが適切に承認されていないことを示す、新しい
forbidden
エラーについて説明しています。 -
channel
リソースのsnippet.channelId
プロパティが削除されました。リソースのid
プロパティは同じ値を提供します。
2013 年 1 月 30 日
この改訂での変更内容は次のとおりです:
-
新しい [エラー] ページには、API が返す可能性があるエラーが一覧表示されます。このページには、複数の異なる API メソッドで発生する可能性のある一般的なエラーと、メソッド固有のエラーが含まれています。
2013 年 1 月 16 日
この改訂での変更内容は次のとおりです:
-
現在、以下のメソッドと言語のコードサンプルを利用できます。
activities.insert
- JavaplaylistItems.insert
- PythonplaylistItems.list
- Java、JavaScript、PHP、Python、Rubyplaylists.insert
– Java、JavaScript、Pythonsearch.list
- Java、JavaScript、Python、Rubyvideos.insert
- Java
-
activity
リソースでchannelItem
アクションを報告できるようになりました。このアクションは、YouTube が自動生成された YouTube チャンネルに動画を追加したときに発生します。(YouTube は、YouTube ウェブサイト上で重要なトピックをアルゴリズムによって識別し、それらのトピックのチャンネルを自動的に生成します)。 -
次の
search.list
パラメータが更新されました。q
パラメータがフィルタとして指定されなくなりました。これはつまり...relatedToVideo
パラメータの名前がrelatedToVideoId
に変更されました。published
パラメータは、publishedAfter
とpublishedBefore
の 2 つの新しいパラメータに置き換えられました。以下に説明します。
-
search.list
メソッドは、次の新しいパラメータをサポートしています。パラメータ名 値 説明 channelId
string
指定したチャネルによって作成されたリソースを返します。 publishedAfter
datetime
指定した時間以降に作成されたリソースを返します。 publishedBefore
datetime
指定した時間より前に作成されたリソースを返します。 regionCode
string
指定された国のリソースを返します。 videoCategoryId
string
動画の検索結果をフィルタして、指定した動画のカテゴリに関連する動画のみが含まれるようにします。 videoEmbeddable
string
動画検索結果をフィルタして、ウェブページに埋め込まれたプレーヤーで再生できる動画のみを表示します。パラメータ値を true
に設定すると、埋め込み可能な動画のみが取得されます。videoSyndicated
string
YouTube.com 以外で再生できる動画のみが含まれるように、動画検索結果をフィルタします。シンジケーション動画のみを取得するには、パラメータ値を true
に設定します。 -
いくつかの API リソースは、新しいプロパティをサポートしています。次の表に、リソースとその新しいプロパティを示します。
リソース プロパティ名 値 説明 activity
contentDetails.playlistItem.playlistItemId
string
再生リスト内のアイテムを一意に識別するために YouTube が割り当てた再生リストのアイテム ID。 activity
contentDetails.channelItem
object
チャンネルに追加されたリソースに関する情報を含むオブジェクト。このプロパティは、 snippet.type
がchannelItem
の場合にのみ存在します。activity
contentDetails.channelItem.resourceId
object
チャンネルに追加されたリソースを識別するオブジェクト。他の resourceId
プロパティと同様に、動画や再生リストなどのリソースタイプを指定するkind
プロパティが含まれています。また、videoId
やplaylistId
などのプロパティのうち 1 つのみも含まれます。このプロパティは、そのリソースを一意に識別する ID を指定します。channel
status
object
このオブジェクトは、チャンネルのプライバシー ステータスに関する情報をカプセル化します。 channel
status.privacyStatus
string
チャンネルのプライバシー ステータス。有効な値は private
とpublic
です。playlist
contentDetails
object
このオブジェクトには、再生リストのコンテンツに関するメタデータが含まれます。 playlist
contentDetails.itemCount
unsigned integer
再生リスト内の動画数。 playlist
player
object
このオブジェクトには、埋め込みプレーヤーで再生リストを再生するために使用する情報が含まれています。 playlist
player.embedHtml
string
再生リストを再生する動画プレーヤーを埋め込む <iframe>
タグ。video
recordingDetails
object
このオブジェクトは、動画が撮影された場所と時間を識別または説明する情報をカプセル化します。 video
recordingDetails.location
object
このオブジェクトには、動画に関連付けられている位置情報が含まれます。 video
recordingDetails.location.latitude
double
緯度。 video
recordingDetails.location.longitude
double
経度。 video
recordingDetails.location.elevation
double
地球からの高度(メートル単位)。 video
recordingDetails.locationDescription
string
動画が撮影された場所のテキストによる説明。 video
recordingDetails.recordingDate
datetime
動画が録画された日付と時刻。値は ISO 8601( YYYY-MM-DDThh:mm:ss.sZ
)形式で指定します。 -
いくつかの API メソッドのドキュメントで、リクエスト本文で指定する必要があるプロパティ、またはリクエスト本文の値に基づいて更新されるプロパティを特定しました。次の表に、これらのメソッドと、必須または変更可能なプロパティを示します。
注: 他の方法のドキュメントには、必須プロパティと変更可能なプロパティがすでに記載されている場合があります。
メソッド プロパティ activities.insert
必須プロパティ: snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
必須プロパティ: id
playlistItems.update
必須プロパティ: id
videos.update
必須プロパティ: id
-
同じチャンネルにすでに存在するプレイリストと同じタイトルのプレイリストを作成または更新しようとした場合、API から
playlistAlreadyExists
エラーが報告されなくなりました。 -
いくつかの API メソッドが新しいエラータイプをサポートします。次の表に、メソッドと新たにサポートされるエラーを示します。
メソッド エラーのタイプ エラーの詳細 説明 guideCategories.list
notFound
notFound
id
パラメータで指定されたガイド カテゴリが見つかりません。guideCategories.list メソッドを使用して、有効な値のリストを取得します。playlistItems.delete
forbidden
playlistItemsNotAccessible
リクエストは適切に認証されていないため、指定された再生リスト アイテムを削除できません。 videoCategories.list
notFound
videoCategoryNotFound
id
パラメータで識別された動画カテゴリが見つかりません。videoCategories.list メソッドを使用して、有効な値のリストを取得します。