このページは Cloud Translation API によって翻訳されました。

変更履歴

このページには、YouTube Data API（v3）の変更点とドキュメントの更新内容が掲載されています。この変更履歴の購読。

2024 年 4 月 30 日

注: これはサポート終了のお知らせです。

この改訂での変更内容は次のとおりです:

API では、チャンネルのディスカッションを挿入または取得する機能がサポートされなくなりました。この変更は、YouTube ウェブサイトでサポートされている機能と一致します。YouTube ウェブサイトでサポートされている機能は、チャンネルにコメントを投稿できません。

2024 年 3 月 13 日

注: これはサポート終了のお知らせです。

この改訂での変更内容は次のとおりです:

関数の sync パラメータ captions.insert と captions.update 個のメソッドサポートが終了しました。YouTube は 2024 年 4 月 12 日時点のものです。

この変更により、デベロッパーは、コンテンツに挿入または更新しないとアップロードに失敗します。

2024 年 3 月 12 日

この改訂での変更内容は次のとおりです:

captions リソースのドキュメントを更新し、snippet.name に許容される最大文字数を記載しました。最大 150 文字です。API から nameTooLong が返されるエラーが発生することがあります。

2024 年 3 月 7 日

注: これはサポート終了のお知らせです。

channel リソースプロパティ brandingSettings.channel.moderateComments のサポートが終了しました。YouTube が停止しますこのパラメータは 2024 年 3 月 7 日時点のものです。

2024 年 1 月 31 日

この改訂での変更内容は次のとおりです:

channels.list メソッドの新しい forHandle パラメータを使用すると、YouTube ハンドルを指定してチャンネルに関する情報を取得できます。

2023 年 11 月 9 日

Comments の videoId リソースへのすべての参照 videoId リソースが API 呼び出しを使用して返されないため、削除されました。

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 メソッドで uploadRateLimitExceeded エラーは、チャンネルのアップロード回数が多すぎることを示します。サムネイルが表示され、後でもう一度試してください。

2023 年 6 月 12 日

注: これはサポート終了のお知らせです。

search.list メソッドの relatedToVideoId パラメータのサポートが終了しました。YouTube は 2023 年 8 月 7 日時点のものです。

現時点で、search.list メソッドのご覧くださいこのパラメータは、search.list のドキュメントから完全に削除されます。 2023 年 8 月 7 日以降

また、関連動画を取得する方法を示すサンプルを API 実装ガイドから削除しました。

2022 年 8 月 22 日

video.statistics の型アノテーションを修正しました。文字列に変換できます。

2022 年 8 月 5 日

YouTube は字幕 ID の生成方法を変更しました。その一環として、すべての字幕トラックに新しい字幕 ID を割り当てます。この変更は、バージョン 4 と 3 のアプリケーションに対する変更を caption_id 個の値がありますが、保存されないアプリケーションにも caption_id 値。

現在から 2022 年 12 月 1 日まで、 captions.list, captions.update, captions.download、およびおよび captions.delete メソッドを実行すると、は、新旧両方の字幕トラック ID をサポートします。2022 年 12 月 1 日以降、YouTube は古い字幕トラック ID のサポートを停止します。その時点で、これらの API メソッドのいずれかを呼び出して、古い字幕トラック ID を使用すると、 captionNotFound エラー。

この変更に備えて、保存されているすべての字幕トラックデータを完全に置き換える必要があります。の期間に 2022 年 12 月 1 日よりつまり、字幕トラックを保存する動画には、現在保存されているデータを削除してから、 captions.list メソッドを使用して、動画の字幕トラックの現在のセットを取得し、通常どおり API レスポンスにデータを格納します。表示されます。

2022 年 7 月 12 日

YouTube API サービスの利用規約が更新されました。恐れ入りますが、 YouTube API Services Terms of Service（英語）- 改訂版履歴をご覧ください。

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 リソースを必要とする場合は、2 番目の呼び出しを commentThreads.list メソッドを使用します。

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 からエラーが返されます。お気に入りのプレイリストを変更しようとするアイテムの追加、変更、削除によるサポートもすべて、以前のお知らせに基づきサポート終了となります。エラーが返されるようになります。
次の channel リソースサポートを終了しました。これらのプロパティは YouTube Studio の管理画面ですでにサポートされていません動画をご覧ください。そのため、API を介したサポートも終了しました。
- brandingSettings.channel.defaultTab
- brandingSettings.channel.featuredChannelsTitle
- brandingSettings.channel.featuredChannelsUrls[]
- brandingSettings.channel.profileColor
- brandingSettings.channel.showBrowseView
- brandingSettings.channel.showRelatedChannels
すべてのプロパティが channel リソース表現があり、その定義はリソースのプロパティリスト。またエラーはは、メソッド固有のドキュメントから削除されました。
次の channelSection リソースサポートを終了しました。これらのプロパティは YouTube Studio の管理画面ですでにサポートされていません動画をご覧ください。そのため、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[] プロパティのサポートが終了しました。このプロパティはすでにサポートされていません 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 の埋め込みプレーヤーを介して収集、送信されるデータに関する追加情報。マイページは、ユーザーがプレーヤーを操作して再生インテントを示します。Google Cloud のプロジェクトと自動再生を false に設定することで、ユーザーがプレーヤーを操作する前に YouTube で再生できます。
新しいセクション III.E.4.j は、コンテンツをサイトに埋め込む前に、そのコンテンツを子ども向け（MFK）ステータスを確認する方法や、。API クライアントに埋め込んだ動画がいつ作成されたかを知る責任は、埋め込みプレーヤーから収集されたデータを適切に処理します。そのため、コンテンツを API に埋め込む前に、YouTube Data API サービスを使用してコンテンツのステータスを確認する YouTube 埋め込みプレーヤーを介したクライアント。

新しい動画の MadeForKids ステータスの確認このガイドでは、 YouTube Data API サービス。

これらの変更に伴い、リマインダーが埋め込みプレーヤーのパラメータに関するドキュメントをご覧ください。自動再生を有効にすると、ユーザーがプレーヤーを操作しなくても再生が開始されます。再生したがって、ページの読み込み時にデータの収集と共有が行われます。

2020 年 10 月 8 日

今回のアップデートでは、 channel リソース:

snippet.thumbnails （チャンネルのサムネイル画像を識別するオブジェクト）が、新しく作成された動画では空になることがあります。最大 1 日かかる場合があります。
statistics.videoCount プロパティには、所有者も含め、チャンネルの公開動画の数のみが反映されます。この動作 YouTube ウェブサイトに表示される数と一致している。
チャンネルキーワード: brandingSettings.channel.keywords 最大文字数の 500 文字（または 500 文字）を超える場合、長さが切り捨てられることがあります。（"）が返されます。500 文字（全角 250 文字）は制限はキーワードごとの制限ではなく、すべてのキーワードの長さに対する制限です。この動作は YouTube ウェブサイトの動作と一致しています。

2020 年 9 月 9 日

注: これはサポート終了のお知らせです。

この更新には、次の API の変更が含まれます。すべての変更は、この日以降に有効になります本発表の日付は 2020 年 9 月 9 日です。このことを念頭に置いて、デベロッパーは、下記のいずれかの API 機能に依存しません。

次の API リソース、メソッド、パラメータ、リソースプロパティは非推奨です。次の発表日以降は機能しなくなります。 <ph type="x-smartling-placeholder">
- 次の channel リソースプロパティ: <ph type="x-smartling-placeholder">
  - statistics.commentCount プロパティ
  - brandingSettings.image オブジェクトとそのすべての子プロパティ
  - brandingSettings.hints リストとそのすべての子プロパティ
- channels.list メソッドの categoryId フィルタパラメータ
- guideCategories リソースおよび guideCategories.list 支払い方法
の API レスポンスは、 channels.list メソッドなしより長い prevPageToken API リクエストで managedByMe パラメータ宛先: true。この変更は prevPageToken プロパティには影響しません。他の channels.list リクエストに対しては使用できません。また、 nextPageToken プロパティを使用します。
channel リソースの contentDetails.relatedPlaylists.watchLater および contentDetails.relatedPlaylists.watchHistory プロパティがともに発表されました 2016 年 8 月 11 日にサポートが終了しました。「 playlistItems.insert メソッドと playlistItems.delete メソッドのサポートこれらの再生リストのサポートも完全に終了し 2 つのプロパティは削除されましたをご覧ください。
channels.list メソッドの mySubscribers パラメータ。 2013 年 7 月 30 日にサポートの終了が発表され、ドキュメントから削除しましたこちらの subscriptions.list メソッドとその mySubscribers パラメータを渡して、チャンネルに登録します。
channel リソースの invideoPromotion オブジェクトとそのすべての子サポートを終了しました。 2017 年 11 月 27 日をドキュメントから削除しました。

2020 年 7 月 29 日

そこで、追加の API リクエストを削除することで、API リクエストの割り当てを請求するプロセスを簡素化しました。 part パラメータに関連する費用が発生します。直ちに有効で、呼び出されたメソッドの基本コスト。詳しくは、割り当てについてはこちらをご覧ください。

この変更により、ほとんどの API 呼び出しの割り当て費用が若干低くなりますが、一部の API 呼び出しの費用は変わりません。この変更によって API の費用が増えることはありませんできます。全体として、割り当てられた割り当てが影響する可能性があります。割り当ての状況は Google Cloud コンソールでは、さらに一歩進んでいます。

すべてのデベロッパーがコンプライアンス監査を行う YouTube API サービスへのアクセスが継続されることを保証します。

この変更履歴項目は 2020 年 7 月 20 日に公開されたものです。

2020 年 7 月 28 日

videos.insert 経由でアップロードされたすべての動画 2020 年 7 月 28 日以降に作成された未確認の API プロジェクトのエンドポイントは、プライベート表示モードになります。この制限を解除するには、各プロジェクトで監査を実施して、準拠していること利用規約。

未確認の 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 の特定の要素を適用しているかについて説明します。置き換えません。このガイドは、Google が作成、管理する API コンプライアンス監査でデベロッパーから尋ねられることがよくあります。これにより、機能開発が簡素化されることを願っています。プロセスを進める中で、Google によるポリシーの解釈と適用について理解を深めていきましょう。

2020 年 6 月 4 日

注: これは、前回のサポート終了のお知らせの更新版です。

チャンネルのお知らせ機能のサポートは完全に終了しました。この変更は当初、に適用され、現在は適用されています。その結果 activities.insert メソッドが no サポートされなくなったため、 activities.list メソッドはチャンネルのお知らせメッセージを返さなくなりました。詳しくは、 YouTube ヘルプセンター

2020 年 4 月 17 日

注: これはサポート終了のお知らせです。

YouTube は、チャンネルのお知らせメッセージ機能を廃止します。その結果 activities.insert メソッドは非推奨、activities.list メソッドはチャンネルのお知らせメッセージを返さなくなります。これらの変更は、 2020 年 5 月 18 日以降詳しくは、 YouTube ヘルプセンター

2020 年 3 月 31 日

この改訂での変更内容は次のとおりです:

新しいリソースとメソッド
- 新しい member リソースは、登録する必要があります。メンバーは定期的な金銭的サポートをクリエイターになり、特別な特典を受けられます。たとえば、メンバーはクリエイターがチャットでメンバー限定モードをオンにしている。
  
  このリソースは sponsor に代わるものですこれは、YouTube Live Streaming API の一部として文書化されています。「 sponsor リソースは非推奨になったため、API クライアントは以下に対する呼び出しを更新する必要があります。 sponsors.list メソッドを使用し、 members.list メソッドを使用してください。
- 新しい membershipsLevel リソースは、API リクエストを承認した作成者が管理する料金レベルを識別します。 membershipsLevels.list メソッドは、クリエイターのすべてのメンバーシップレベルのリストを取得します。

2020 年 1 月 10 日

この API で、子ども向けコンテンツを識別する機能がサポートされるようになりました。子ども向けコンテンツでは、「子ども向けに制作された」詳細: 「子ども向け」コンテンツをご覧ください。

channel と video リソースは、次の 2 つの新しいプロパティをサポートします。コンテンツのクリエイターと視聴者が子ども向けに制作されたコンテンツを識別できるようにする:

selfDeclaredMadeForKids プロパティを使用すると、コンテンツクリエイターは、 channel または動画が子ども向けである。

チャネルの場合、このプロパティは、 channels.update メソッドを使用します。動画の場合このプロパティは、 videos.insert または videos.update メソッド。

このプロパティは、channel またはチャンネル所有者が API リクエストを承認した場合は video リソース。
madeForKids プロパティを使用すると、すべてのユーザーが「子ども向け」コンテンツを取得できます。ステータスチャンネル動画をご覧ください。たとえば、ステータスが「 selfDeclaredMadeForKids プロパティの値に基づいて決定されます。詳しくは、詳しくは、YouTube ヘルプセンターをご覧ください。チャンネル、動画、配信の視聴者設定に関する情報。

また、YouTube API サービスの利用規約とデベロッパーポリシーも更新しました。恐れ入りますが、 YouTube API Services Terms of Service（英語）- 改訂版履歴をご覧ください。YouTube API サービス利用規約の変更とデベロッパーポリシーは 2020 年 1 月 10 日（太平洋時間）に施行されます。

2019 年 9 月 10 日

API リファレンスドキュメントが更新され、サブスクライバーによる報告される回数は YouTube 上で報告され、結果として API レスポンスでも報告されます。この変更により、 YouTube Data API サービスから返されるチャンネル登録者数は、3 桁に切り捨てられます。チャンネル登録者数が 1,000 人以上の場合。この変更は 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万
1234,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 レスポンスを確認できます。このウィジェットでは、コードサンプルの全画面表示が全画面表示されます。コードサンプルは、入力したスコープと値を使用するように動的に更新されます。
- 一般的なユースケースのセクションでは、このページで説明した方法の一般的なユースケースを 1 つ以上説明します。たとえば、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 ドメインでのみ使用できるようになります。これは、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 でサポートされている注目動画機能と注目ウェブサイト機能のサポートを終了します。そのため、このオブジェクト（そのすべての子プロパティを含む）のサポートは終了します。

2017 年 12 月 14 日までは、引き続き invideoPromotion のデータを取得して設定することができます。この日以降は、次のようになります。
- 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 ウェブサーバーアプリケーションの完全なコードサンプルも提供されるようになりました。これらのアプリケーションでは、少し異なる認証フローが使用されています。すべてのサンプル（およびこの変更）を表示するには:
1. インタラクティブなコードスニペットツールまたは channels.list メソッドなどの API メソッドのドキュメントをご覧ください。
2. コードサンプルの上にある Python タブをクリックします。
3. スニペット表示からサンプル全体に切り替えるには、タブの上の切り替えボタンをクリックします。
4. このタブに、InstalledAppFlow 承認フローを使用する完全なコードサンプルが表示されます。サンプル上の説明では、この点について説明し、ウェブサーバーアプリケーションのサンプルへのリンクも記載しています。
5. リンクをクリックしてウェブサーバーの例に切り替えます。このサンプルでは、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 のインタラクティブなコードスニペットツールに、ツールの機能を説明するドキュメントが追加されました。 <ph type="x-smartling-placeholder">
- API リクエストの実行
- コードスニペットとコードサンプル全体の切り替え
- ボイラープレート関数の使用
- 既存のリソースを読み込む（update メソッドの場合）
注: このツールは、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 トピックは削除されました。

名前	トピック ID
ビジネス	`/m/09s1f`
健康	`/m/0kt51`
軍事	`/m/01h6rj`
政治	`/m/05qt0`
宗教	`/m/06bvp`

この変更により、動画に関連するトピックは常に 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 個作成できることを記載しました。
  
  さらに、channelSection リソースの targeting プロパティが更新され、ターゲティングオプションを設定できるのは API のみであることが反映されました。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` オブジェクトが無効であることを示すこのエラーを返します。このエラーが発生する理由の 1 つは、`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 セットのみが返されるようになります。スポーツやバスケットボールなどの大まかな分類は特定できますが、特定のチームや選手は特定されません。この変更に備えて申請の準備に時間をかけられるように、サポート対象のトピックについてお知らせいたします。
- 2017 年 2 月 10 日までは、すでに取得した Freebase のトピック ID はすべてコンテンツの検索に使用できます。ただし、この期間を過ぎると、前のアイテムで特定された少数のトピックのみを使用して、トピック別の検索結果を取得できます。
- 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 の値を返します。
  
  2016 年 9 月 12 日以降、チャンネルの再生履歴または「後で見る」再生リストの再生リストの詳細（playlists.list）を取得するリクエストでは、空のリストが返されます。これらの再生リストのいずれかに含まれる再生リストアイテム（playlistItems.list）を取得するリクエストも、この時間を過ぎると空のリストを返します。これは、新しい値の HL と WL のほか、API クライアントがすでに保存した再生履歴や後で見る再生リストの ID にも当てはまります。
- 2016 年 9 月 12 日以降、video リソースの fileDetails.recordingLocation オブジェクトまたはその子プロパティは返されなくなります。親 fileDetails オブジェクトを取得できるのは動画の所有者のみであるため、このデータを取得できるのは動画の所有者のみです。

2016 年 6 月 13 日

この改訂での変更内容は次のとおりです:

channel リソースの contentDetails.googlePlusUserId プロパティが非推奨になりました。これまでは、チャンネルが Google+ プロフィールに関連付けられている場合にのみ、プロパティが存在していました。サポート終了以降、このプロパティはどの channel リソースにも含まれなくなります。
comment リソースの snippet.authorGoogleplusProfileUrl プロパティが非推奨になりました。これまでは、チャンネルが Google+ プロフィールに関連付けられている場合にのみ、プロパティが存在していました。サポート終了以降、このプロパティはどの comment リソースにも含まれなくなります。

サポート終了後は、どちらのプロパティも返されないため、対応するリソースドキュメントから両方のプロパティを削除しました。

2016 年 5 月 31 日

この改訂での変更内容は次のとおりです:

subscriptions.list メソッドの新しい myRecentSubscribers パラメータは、認証されたユーザーのチャンネル登録者のリストを、チャンネル登録した時間と新しい順で取得します。

新しいパラメータで取得できるのは、認証されたユーザーの最新のチャンネル登録者数 1,000 人のみです。サブスクライバーの完全なリストを取得するには、mySubscribers パラメータを使用します。このパラメータは特定の順序でサブスクライバーを返しませんが、取得できるサブスクライバーの数は制限されません。
activity、playlistItem、playlist、検索結果、サムネイル、動画の各リソースの snippet.thumbnails.(key) プロパティの定義が更新され、一部の動画では追加のサムネイル画像サイズが利用できるようになりました。
- 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 Developer's Console にリンクしました。このコンソールで、実際の割り当てと割り当ての使用状況を確認できます。

2016 年 3 月 16 日

この改訂での変更内容は次のとおりです:

既存のリソースとメソッドの更新
- channelBanner リソースのドキュメントが更新され、アップロードされたチャンネルバナー画像の推奨サイズが 2560px x 1440px であることが記載されています。最小サイズ（2,048 x 1,152 ピクセル）に変更はありません。
- channel リソースの新しい snippet.customUrl プロパティによって、チャンネルに関連付けられたカスタム URL が識別されます。（すべてのチャンネルにカスタム URL があるわけではありません）。カスタム URL を取得するための資格要件と URL の設定方法については、YouTube ヘルプセンターをご覧ください。
- 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 では、リソースのローカライズされた値を取得する方法が 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 プロパティが非推奨になりました。
  
  Google のサポート終了ポリシーに基づき、このプロパティは、このお知らせから少なくとも 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 Developers Console でデベロッパーのアプリケーションに関連付けられているプロジェクト番号が自動的にタグ付けされます。
  
  その後、検索リクエストで 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 メソッドのドキュメントが変更され、成功すると、これらのメソッドがすべて HTTP 204 レスポンスコード（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`	API ユーザーが `snippet.parentId` プロパティで識別される最上位コメントに返信してコメントを挿入できない場合、`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 – コメントを削除します。
comments.insert、comments.update、comments.markAsSpam、comments.setModerationStatus、comments.delete、commentThreads.insert、commentThreads.update の各メソッドの呼び出しには、API の新しい https://www.googleapis.com/auth/youtube.force-ssl スコープ（2015 年 4 月 2 日の変更履歴に記載）が必要です。
新しいプッシュ通知への登録ガイドでは、ウェブアクセス可能なリソースのためのサーバー間のパブリッシュ/サブスクライブプロトコルである 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 動画にのみ関連付けられます。

この API は、字幕トラックの一覧表示、挿入、更新、ダウンロード、削除のメソッドをサポートしています。
移行ガイドも更新され、v2 API の字幕機能を引き続き使用しているアプリケーションを移行する方法が説明されています。
API の新しい https://www.googleapis.com/auth/youtube.force-ssl スコープでは、SSL 接続を介して API サーバーと通信する必要があります。

この新しいスコープは、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 の場合、リソースは新しいチャンネル登録動画に対応します。レスポンスに特定の数の新しいチャンネル登録動画が含まれる保証はありません。
- RSS フィードのサポート
- フィード更新のプッシュ通知 – 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 メソッドの説明が更新され、各 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 エラーが返されます。このエラーには、HTTP 400 ステータスコードが含まれます。
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 がこれらのメソッドへのリクエストが成功すると HTTP 204 レスポンスコードを返すことが反映されるようになりました。

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 からエラーが返されます。
動画の挿入または更新時に設定できる値のリストに、次の video リソースプロパティが追加されました。
エラードキュメントに、各エラータイプの 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 が見つからないか、プロモートアイテムとして使用できない場合に、`channels.update` メソッドがこのエラーを返します。
`forbidden (403)`	`websiteLinkNotAllowed`	許可されていない URL が `invideoPromotion.items[].id.websiteUrl` プロパティで指定されている場合、`channels.update` メソッドがこのエラーを返します。
`required (400)`	`requiredTimingType`	プロモートアイテムを表示するタイミングについて、リクエストにデフォルトのタイミング設定が指定されていない場合、`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 日

この改訂での変更内容は次のとおりです:

search.list メソッドのドキュメントが更新され、検索リクエストを送信するときにフィルタパラメータの値を 1 つだけ指定する必要がないことが正しく反映されました。一方、0 個のフィルタパラメータまたは 1 個のフィルタパラメータの値を設定することができます。
search.list メソッドのパラメータの定義が更新され、次のいずれかのパラメータにも値を指定する場合は、type パラメータの値を video に設定する必要があります。
- eventType
- videoCaption
- videoCategoryId
- videoDefinition
- videoDimension
- videoDuration
- videoEmbeddable
- videoLicense
- videoSyndicated
- videoType
アップロードできるチャンネルバナー画像の最小サイズは 2,048 ピクセル x 1,152 ピクセルに縮小されました。（これまでの最小サイズは 2,120 x 1,192 ピクセルでした）。また、channel リソースドキュメントには、API から提供されるすべてのバナー画像の最大サイズが規定されています。たとえば、テレビで使用する brandingSettings.image.bannerTvImageUrl 画像の最大サイズは 2120 x 1192 ピクセルですが、実際の画像は 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 プロパティは、カナダの TV 分類システム（カナダの TV 分類システム）とフランス語の 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 プロパティは、イタリアのベニエデッレアッティヴィータカルチャーカルチャーエデルトゥリスモによる動画の評価を示します。

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`	認証されたユーザーが YouTube パートナーであるリクエストでは、`mine` パラメータを使用できません。`mine` パラメータを削除するか、`onBehalfOfContentOwner` パラメータを削除して YouTube ユーザーとして認証するか、呼び出されたメソッドで使用できる場合は `onBehalfOfContentOwnerChannel` パラメータを指定して、パートナーのチャンネルの 1 つとして機能する必要があります。

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 プロパティは、年齢制限のあるコンテンツを識別します。動画に 18 歳未満のユーザーにとって不適切なコンテンツが含まれていると YouTube が特定した場合、このプロパティ値は 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 日

この改訂での変更内容は次のとおりです:

スタンドアロンページには、Java、.NET、PHP、Ruby のコードサンプルが掲載されるようになりました。
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 オブジェクトは、さまざまな評価スキームで動画が受けた評価をカプセル化します。以下のリストでは、サポートされているレーティングシステムを特定し、各レーティングシステムに関連付けられている宿泊施設へのリンクを示します。プロパティの定義は、各システムでサポートされている評価値を識別します。

国	レーティングシステム	プロパティ
米国	アメリカ映画協会（MPAA）	`contentDetails.contentRating.mpaaRating`
米国	テレビのペアレンタルガイドライン	`contentDetails.contentRating.tvpgRating`
オーストラリア	Australia Classification Board（ACB）	`contentDetails.contentRating.acbRating`
ブラジル	Departamento de Justiça、Classificação、Qualificação e Títulos	`contentDetails.contentRating.djctqRating`
カナダ	Canadian Home Video Rating System（CHVRS）	`contentDetails.contentRating.chvrsRating`
フランス	Centre National du cinéma et de l'image animée（フランス文化省）	`contentDetails.contentRating.fmocRating`
ドイツ	Freiwillige Selbstkontrolle der Filmwirtschaft（FSK）	`contentDetails.contentRating.fskRating`
イギリス	英国映画分類委員会（BBFC）	`contentDetails.contentRating.bbfcRating`
インド	Central Board of Film Certification（CBFC）	`contentDetails.contentRating.cbfcRating`
日本	映画倫理委員会（映倫）	`contentDetails.contentRating.eirinRating`
韓国	영자입씴（KMRB）	`contentDetails.contentRating.kmrbRating`
メキシコ	ラジオ、テレビ、映画撮影総局（RTC）	`contentDetails.contentRating.rtcRating`
ニュージーランド	映画文学分類庁	`contentDetails.contentRating.oflcRating`
ロシア	ロシア連邦国立映画登録簿	`contentDetails.contentRating.russiaRating`
スペイン	Instituto de la Cinematografía y de las Artes Audiovisuales（ICAA）	`contentDetails.contentRating.icaaRating`

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`	リクエストメタデータが無効です。

videos.update メソッドと videos.delete メソッドでサポートされているパラメータのリストから onBehalfOfContentOwner パラメータを削除しました。

2013 年 3 月 12 日

この改訂での変更内容は次のとおりです:

次のリソースの snippet に channelTitle プロパティが追加されました。
- activity - このプロパティは、アクティビティを担当するチャネルの名前を指定します。
- search – このプロパティは、検索結果で識別されるリソースに関連付けられているチャンネルの名前を指定します。
- video – このプロパティは、動画をアップロードしたチャンネルの名前を指定します。
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 です。
videos.list、videos.insert、videos.update の各メソッドの part パラメータの定義が更新され、上記の新しく追加されたパーツと、誤って省略された 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 - Java
- playlistItems.insert – Python
- playlistItems.list – Java、JavaScript、PHP、Python、Ruby
- playlists.insert – Java、JavaScript、Python
- search.list – Java、JavaScript、Python、Ruby
- videos.insert - Java
activity リソースで、channelItem アクションを報告できるようになりました。これは、自動生成された YouTube チャンネルに YouTube が動画を追加したときに発生します。（YouTube は、YouTube ウェブサイト上で重要なトピックをアルゴリズムによって識別し、それらのトピックのチャンネルを自動的に生成します）。
次の search.list パラメータが更新されました。
- q パラメータがフィルタとして指定されなくなりました。これはつまり...
- relatedToVideo パラメータの名前が relatedToVideoId に変更されました。
- published パラメータが、以下に説明する 2 つの新しいパラメータ publishedAfter と publishedBefore に置き換えられました。

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 メソッドを使用して、有効な値のリストを取得します。