YouTube ショート動画の視聴回数のカウント方法に合わせて、Data API を更新します。詳細

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

変更履歴
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。

このページでは、YouTube Data API（v3）の変更とドキュメントの更新内容の一覧を示します。この変更ログの配信登録。

2025 年 3 月 26 日

2025 年 3 月 31 日より、YouTube ショートの視聴回数のカウント方法が変更されます。これまで、ショート動画では、ショート動画が一定の秒数再生された後に視聴回数としてカウントされていました。今後は、ショート動画の再生または繰り返し再生が開始された回数が視聴回数としてカウントされ、最短再生時間の要件はなくなります。詳細

2025 年 3 月 31 日より、Data API の次のフィールドで、この変更に従ってショート動画の視聴回数が返されるようになります。

channels.statistics.viewCount
videos.statistics.viewCount

2024 年 10 月 30 日

この API では、実物のように見える改変または合成（A/S）コンテンツを含む動画を特定できるようになりました。詳しくは、A/S コンテンツに関する YouTube のポリシーをご覧ください。

A/S コンテンツの例としては、次のような動画が挙げられます。

実在の人物が実際には発言または行動していないことを、発言または行動しているように見せている
実際の出来事や場所の映像を改変している
実際には起きていない場面が現実のように見えるコンテンツを生成している

動画に A/S コンテンツが含まれているかどうかを示すには、status.containsSyntheticMedia プロパティを設定します。このプロパティは、videos.insert メソッドまたは videos.update メソッドを呼び出すときに設定できます。設定されている場合、このプロパティは video リソースで返されます。

2024 年 4 月 30 日

注: これは非推奨のお知らせです。

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

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

2024 年 3 月 13 日

注: これは非推奨のお知らせです。

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

captions.insert メソッドと captions.update メソッドの sync パラメータのサポートが終了しました。このパラメータのサポートは、2024 年 4 月 12 日をもって終了します。

この変更により、デベロッパーは字幕トラックを挿入または更新するときにタイミング情報を含める必要があります。含めないと、アップロードが失敗します。

2024 年 3 月 12 日

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

captions リソースのドキュメントが更新され、snippet.name フィールドの最大長が 150 文字であることが明記されました。トラック名がそれより長い場合、API は nameTooLong エラーを返します。

2024 年 3 月 7 日

注: これは非推奨のお知らせです。

channel リソースプロパティ brandingSettings.channel.moderateComments は非推奨になりました。YouTube では、2024 年 3 月 7 日をもってこのパラメータのサポートを終了します。

2024 年 1 月 31 日

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

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

2023 年 11 月 9 日

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

2023 年 9 月 12 日

注: これは非推奨のお知らせです。

comments.markAsSpam メソッドは数年前に非推奨になりました。この方法はすでに YouTube でサポートされておらず、API でもサポートされなくなりました。

comments.markAsSpam メソッドを参照するすべてのドキュメントに、非推奨に関する通知が追加されました。

2023 年 8 月 22 日

search.list メソッドが videoPaidProductPlacement パラメータをサポートするようになりました。このパラメータを使用すると、クリエイターが有料プロモーションとして指定した動画のみを検索結果に含めるようにフィルタできます。

2023 年 8 月 18 日

video リソースの liveStreamingDetails.concurrentViewers の定義が更新され、YouTube Data API が返す同時視聴者数は、YouTube アナリティクスで利用可能な、処理されスパム除去された同時視聴者数と異なる可能性があることが明記されました。ライブ配信の指標について詳しくは、YouTube ヘルプセンターをご覧ください。

2023 年 8 月 7 日

2023 年 6 月 12 日に発表されたとおり、search.list メソッドの relatedToVideoId パラメータは非推奨になりました。このパラメータはサポートが終了しており、API ドキュメントからパラメータへの参照が削除されています。

2023 年 6 月 28 日

thumbnails.set メソッドで uploadRateLimitExceeded エラーがサポートされるようになりました。これは、チャンネルが過去 24 時間にアップロードしたサムネイルが多すぎることを示します。しばらくしてからもう一度お試しください。

2023 年 6 月 12 日

注: これは非推奨のお知らせです。

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

現時点では、search.list メソッドのドキュメントに非推奨に関する通知が追加されています。このパラメータは、2023 年 8 月 7 日以降、search.list のドキュメントから完全に削除されます。

また、関連動画を取得する方法の例が API 実装ガイドから削除されました。

2022 年 8 月 22 日

video.statistics フィールドの型アノテーションを、unsigned long から string に修正しました。

2022 年 8 月 5 日

YouTube は字幕 ID の生成方法を変更しました。その変更の一環として、すべての字幕トラックに新しい字幕 ID が割り当てられます。この変更は、caption_id 値を保存するアプリに対して下位互換性のない変更になる可能性がありますが、caption_id 値を保存しないアプリには影響しません。

2022 年 12 月 1 日までは、captions.list、captions.update、captions.download、captions.delete の各メソッドで、古い字幕トラック ID と新しい字幕トラック ID の両方がサポートされます。ただし、2022 年 12 月 1 日以降、YouTube は古い字幕トラック ID のサポートを終了します。その時点で、古い字幕トラック ID を使用してこれらの API メソッドを呼び出すと、captionNotFound エラーが発生します。

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

2022 年 7 月 12 日

YouTube API サービスの利用規約が更新されました。詳しくは、YouTube API サービスの利用規約 - 改訂履歴をご覧ください。

2022 年 4 月 27 日

videos.insert メソッドの説明を更新し、アップロードする動画の最大ファイルサイズが 128 GB から 256 GB に引き上げられたことを記載しました。

2022 年 4 月 8 日

subscriptions.list メソッドの myRecentSubscribers パラメータと mySubscribers パラメータの定義が更新され、API から返されるサブスクライバーの最大数が制限される可能性があることが明記されました。この変更はドキュメントの修正であり、API の動作の変更ではありません。

2021 年 12 月 15 日

2021 年 11 月 18 日に発表されたYouTube プラットフォーム全体で動画の低評価数を非公開にする変更に伴い、video リソースの statistics.dislikeCount プロパティが非公開になりました。

この変更について詳しくは、YouTube の公式ブログをご覧ください。

2021 年 11 月 18 日

YouTube プラットフォーム全体で動画の低評価数が非公開になる変更に伴い、video リソースの statistics.dislikeCount プロパティは 2021 年 12 月 13 日をもって非公開になります。つまり、このプロパティが videos.list エンドポイントからの API レスポンスに含まれるのは、API リクエストが動画所有者によって認証された場合のみです。

videos.rate エンドポイントは、この変更の影響を受けません。

低評価数を公開せずに、API クライアントで低評価数を必要とするデベロッパーは、除外対象として許可リストに登録するよう申請できます。免除を申請するには、こちらの申請フォームに記入する必要があります。

この変更について詳しくは、YouTube の公式ブログをご覧ください。

2021 年 7 月 2 日

注: これは非推奨のお知らせです。

commentThreads.update エンドポイントは非推奨となり、サポートを終了しました。このエンドポイントは、他の API エンドポイントで利用可能な機能を複製していました。代わりに、comments.update を呼び出すことができます。

メソッドを呼び出し、コードで commentThreads リソースが必要な場合は、commentThreads.list メソッドを 2 回呼び出します。

2021 年 7 月 1 日

YouTube の API サービスを使用しているすべてのデベロッパーは、デフォルトの割り当てである 10,000 ユニットを超える割り当てを取得するには、API コンプライアンス監査を完了する必要があります。これまで、コンプライアンス監査プロセスと追加の割り当て単位の割り当てリクエストは、デベロッパーが YouTube API サービス - 監査と割り当て増加フォームに記入して送信することで行われてきました。

これらのプロセスを明確にし、API サービスを利用するデベロッパーのニーズをよりよく満たすため、3 つの新しいフォームと、それらのフォームの記入方法に関するガイドを追加します。

監査済みデベロッパーリクエストフォーム: API コンプライアンス監査に合格済みのデベロッパーは、こちらの簡易フォームに必要事項を入力して送信することで、割り当てられた割り当ての延長をリクエストできます。
再審査請求フォーム: API プロジェクトがコンプライアンス監査に不合格となった（または割り当て単位の増加が拒否された）デベロッパーは、このフォームに記入して送信できます。
支配権の変更フォーム: API プロジェクトに関連する支配権の変更（株式の売買、合併、その他の企業取引など）が発生したデベロッパーまたはデベロッパーに代わって API クライアントを運営する当事者は、このフォームに記入して送信する必要があります。これにより、YouTube の API チームはレコードを更新し、新しい API プロジェクトのユースケースの準拠性を確認して、デベロッパーの現在の割り当てを確認できます。

新しいフォームを送信するたびに、YouTube の API の使用目的が Google に通知され、より適切なサポートを受けることができます。

詳しくは、新しい API コンプライアンス監査のガイドをご覧ください。

2021 年 5 月 12 日

注: これは非推奨のお知らせです。

この更新では、次の API の変更が対象となります。

channel リソースの contentDetails.relatedPlaylists.favorites プロパティは非推奨になりました。2016 年 4 月 28 日の変更履歴のエントリに記載されているように、お気に入りの動画機能はすでに数年前に非推奨になっています。

この更新前は、API クライアントが存在しないお気に入りプレイリストに動画を追加しようとした場合でも、API は新しいプレイリストを作成していました。今後、この場合、再生リストは作成されず、API はエラーを返します。アイテムの追加、変更、削除によるお気に入りの再生リストの変更も、以前のお知らせに従ってすべて非推奨となり、いつでもエラーが返される可能性があります。
次の channel リソースプロパティは非推奨になりました。これらのプロパティは、YouTube Studio の UI と YouTube ですでにサポートされていません。そのため、API 経由でのサポートも終了しました。
- brandingSettings.channel.defaultTab
- brandingSettings.channel.featuredChannelsTitle
- brandingSettings.channel.featuredChannelsUrls[]
- brandingSettings.channel.profileColor
- brandingSettings.channel.showBrowseView
- brandingSettings.channel.showRelatedChannels
すべてのプロパティは channel リソース表現から削除され、その定義はリソースのプロパティリストから削除されました。また、これらのプロパティに関連するエラーは、メソッド固有のドキュメントから削除されました。
次の channelSection リソースプロパティは非推奨になりました。これらのプロパティは、YouTube Studio の UI と YouTube ですでにサポートされていません。そのため、API 経由でのサポートも終了しました。
- snippet.style
- snippet.defaultLanguage
- snippet.localized.title
- localizations
- localizations.(key)
- localizations.(key).title
- targeting
- targeting.languages[]
- targeting.regions[]
- targeting.countries[]
この変更に伴い、channelSection.list メソッドの hl パラメータも非推奨になりました。このパラメータがサポートする機能がサポートされていないためです。

すべてのプロパティは channelSection リソース表現から削除され、その定義はリソースのプロパティリストから削除されました。また、これらのプロパティに関連するエラーは、メソッド固有のドキュメントから削除されました。
channelSection リソースの snippet.type プロパティでは、次の値が非推奨になりました。これらの値はすでに YouTube チャンネルページでサポートされておらず、その結果、API でもサポートされなくなりました。
- likedPlaylists
- likes
- postedPlaylists
- postedVideos
- recentActivity
- recentPosts
playlist リソースの snippet.tags[] プロパティは非推奨になりました。このプロパティは YouTube ですでにサポートされておらず、その結果、API 経由でのサポートも終了しています。

2021 年 2 月 9 日

playlistItem リソースは、次の 2 つの新しいプロパティをサポートしています。

snippet.videoOwnerChannelId プロパティは、再生リスト動画をアップロードしたチャンネルの ID を識別します。
snippet.videoOwnerChannelTitle プロパティは、再生リスト動画をアップロードしたチャンネルの名前を識別します。

2021 年 1 月 28 日

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

playlistItems.delete、playlistItems.insert、playlistItems.list、playlistItems.update、playlists.delete、playlists.list、playlists.update の各メソッドは、新しい playlistOperationUnsupported エラーをサポートしています。このエラーは、リクエストで特定の再生リストで許可されていないオペレーションを実行しようとした場合に発生します。たとえば、ユーザーはアップロードした動画の再生リストから動画を削除したり、再生リスト自体を削除したりすることはできません。

いずれの場合も、このエラーは 400 HTTP レスポンスコード（不正なリクエスト）を返します。
playlistItems.list メソッドの watchHistoryNotAccessible エラーと watchLaterNotAccessible エラーがドキュメントから削除されました。ユーザーの再生履歴と [後で見る] リストには API からアクセスできませんが、API からこれらのエラーが返されることはありません。

2020 年 10 月 15 日

デベロッパーポリシーに、次の 2 つの新しいセクションが追加されました。

新しいセクション III.E.4.i では、YouTube 埋め込みプレーヤーを介して収集および送信されるデータに関する追加情報を提供しています。ユーザーがプレーヤーを操作して再生の意図を示した前後に、YouTube 埋め込みプレーヤーを介して Google に送信されるユーザーデータについては、お客様が責任を負います。自動再生を false に設定すると、ユーザーがプレーヤーを操作する前に YouTube と共有されるデータを制限できます。
新しいセクション III.E.4.j は、サイトやアプリに埋め込む前にコンテンツの子ども向け（MFK）ステータスを確認することに関するものです。API クライアントに埋め込む動画が子ども向けであるかどうかを把握し、埋め込みプレーヤーから収集されたデータを適切に処理する責任は、お客様にあります。そのため、YouTube 埋め込みプレーヤーを介して API クライアントに埋め込む前に、YouTube Data API サービスを使用してコンテンツのステータスを確認する必要があります。

新しい動画の子ども向けステータスを確認するガイドでは、YouTube Data API Service を使用して動画の子ども向けステータスを検索する方法について説明しています。

これらの変更に伴い、埋め込みプレーヤーパラメータのドキュメントに、自動再生を有効にすると、プレーヤーに対するユーザー操作なしで再生が開始され、再生データの収集と共有がページの読み込み時に行われることを説明する注意事項が追加されました。

2020 年 10 月 8 日

この更新では、channel リソースに関連する 3 つの小さな変更が含まれています。

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

2020 年 9 月 9 日

注: これは非推奨のお知らせです。

この更新では、次の API の変更が対象となります。すべての変更は、本お知らせの日付である 2020 年 9 月 9 日以降に有効になります。そのため、デベロッパーは、以下に記載されている API 機能に依存しないでください。

次の API リソース、メソッド、パラメータ、リソースプロパティは直ちに非推奨となり、このお知らせの日以降は機能しなくなります。
- 次の channel リソースプロパティ:
  - statistics.commentCount プロパティ
  - brandingSettings.image オブジェクトとそのすべての子プロパティ
  - brandingSettings.hints リストとそのすべての子プロパティ
- channels.list メソッドの categoryId フィルタパラメータ
- guideCategories リソースと guideCategories.list メソッド
API リクエストで managedByMe パラメータを true に設定すると、channels.list メソッドの API レスポンスに prevPageToken プロパティが含まれなくなりました。この変更は、他の channels.list リクエストの prevPageToken プロパティには影響しません。また、どのリクエストの nextPageToken プロパティにも影響しません。
channel リソースの contentDetails.relatedPlaylists.watchLater プロパティと contentDetails.relatedPlaylists.watchHistory プロパティは、2016 年 8 月 11 日に非推奨として発表されました。これらの再生リストに対する playlistItems.insert メソッドと playlistItems.delete メソッドのサポートも完全に非推奨になり、2 つのプロパティはドキュメントから削除されました。
channels.list メソッドの mySubscribers パラメータは、2013 年 7 月 30 日に非推奨と発表されたため、ドキュメントから削除されました。subscriptions.list メソッドとその mySubscribers パラメータを使用して、認証済みユーザーのチャンネルのチャンネル登録者のリストを取得します。
channel リソースの invideoPromotion オブジェクトとそのすべての子プロパティは、2017 年 11 月 27 日に非推奨として発表されました。これらのプロパティはドキュメントから削除されました。

2020 年 7 月 29 日

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

この変更の影響により、ほとんどの API 呼び出しの割り当て費用がわずかに低下しますが、一部の API 呼び出しの費用は変わりません。この変更によって API 呼び出しの費用が増加することはありません。全体的な影響としては、Google Cloud コンソールで確認できる割り当てられた割り当てが少し長くなる可能性があります。

YouTube API サービスへの継続的なアクセスを確保するため、すべてのデベロッパーはプロジェクトのコンプライアンス監査を完了することを強くおすすめします。

このリビジョン履歴のエントリは、2020 年 7 月 20 日に最初に公開されました。

2020 年 7 月 28 日

2020 年 7 月 28 日以降に作成された未確認の API プロジェクトから videos.insert エンドポイント経由でアップロードされた動画はすべて、非公開の視聴モードに制限されます。この制限を解除するには、各プロジェクトで監査を受け、利用規約への準拠を確認する必要があります。

未確認の API クライアントを使用して動画をアップロードしたクリエイターには、動画が非公開としてロックされ、公式または監査済みのクライアントを使用することで制限を回避できることを説明するメールが届きます。

2020 年 7 月 28 日より前に作成された API プロジェクトは、現在、この変更の影響を受けません。ただし、YouTube API サービスへの継続的なアクセスを確保するため、すべてのデベロッパーはプロジェクトのコンプライアンス監査を完了することを強くおすすめします。

2020 年 7 月 21 日

[2020 年 7 月 28 日更新] このリビジョン履歴エントリで参照されているドキュメントの更新は、2020 年 7 月 28 日に再公開されました。

昨日、割り当てを請求するプロセスに関するドキュメントの更新を公開しました。ただし、予期せぬ状況により、割り当ての変更はまだ有効になっていません。そのため、正確性を保つため、ドキュメントを元に戻しました。混乱を避けるため、変更内容を説明する変更履歴エントリは削除されました。このエントリは近日中に再公開されます。

2020 年 7 月 7 日

注: これは非推奨のお知らせです。

videos.insert メソッドの autoLevels パラメータと stabilize パラメータは非推奨になりました。両方のパラメータはドキュメントから削除されました。これらの値は無視され、新しくアップロードされた動画の処理方法には影響しません。

2020 年 6 月 15 日

新しい YouTube デベロッパーポリシーに準拠するガイドでは、API クライアントが YouTube API サービスの利用規約とポリシー（API TOS）の特定の部分に準拠できるようにするためのガイダンスと例が示されています。

このガイダンスは、YouTube が API 利用規約の特定の側面をどのように適用しているかについて説明するものですが、既存のドキュメントに代わるものではありません。このガイドでは、API コンプライアンス監査中にデベロッパーから寄せられるよくある質問の一部を取り上げています。このガイドが、Google によるポリシーの解釈と適用方法を理解し、機能開発プロセスを簡素化する一助となることを願っております。

2020 年 6 月 4 日

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

チャンネルメッセージ機能のサポートが完全に終了しました。この変更は 2020 年 4 月 17 日に最初に発表されました。この変更は現在有効になっています。そのため、activities.insert メソッドはサポートされなくなり、activities.list メソッドはチャンネルメッセージの返却を停止しました。詳しくは、YouTube ヘルプセンターをご覧ください。

2020 年 4 月 17 日

注: これは非推奨のお知らせです。

YouTube はチャンネルメッセージ機能をサポート終了します。そのため、activities.insert メソッドは非推奨になり、activities.list メソッドはチャンネルメッセージの返却を停止します。これらの変更は、2020 年 5 月 18 日以降に API で有効になります。詳しくは、YouTube ヘルプセンターをご覧ください。

2020 年 3 月 31 日

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

新しいリソースとメソッド
- 新しい member リソースは、YouTube チャンネルのチャンネルメンバーを表します。メンバーはクリエイターに定期的な金銭的支援を提供し、特別な特典を受け取ります。たとえば、クリエイターがチャットのメンバー限定モードをオンにすると、メンバーはチャットに参加できます。
  
  このリソースは、YouTube Live Streaming API の一部としてドキュメント化されている sponsor リソースに代わるものです。sponsor リソースは非推奨になりました。API クライアントは、sponsors.list メソッドの呼び出しを更新して、代わりに members.list メソッドを使用する必要があります。
- 新しい membershipsLevel リソースは、API リクエストを承認したクリエイターが管理する料金レベルを識別します。membershipsLevels.list メソッドは、クリエイターのすべてのメンバーシップレベルのリストを取得します。

2020 年 1 月 10 日

この API は、子ども向けコンテンツ（YouTube では「子ども向け」）を特定する機能をサポートするようになりました。「子ども向け」コンテンツについて詳しくは、YouTube ヘルプセンターをご覧ください。

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

selfDeclaredMadeForKids プロパティを使用すると、コンテンツクリエイターはチャンネルまたは動画が子ども向けかどうかを指定できます。

チャンネルの場合、このプロパティは channels.update メソッドを呼び出すときに設定できます。動画の場合は、videos.insert メソッドまたは videos.update メソッドを呼び出すときにこのプロパティを設定できます。

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

また、YouTube API サービスの利用規約とデベロッパーポリシーも更新しました。詳しくは、YouTube API サービスの利用規約 - 改訂履歴をご覧ください。YouTube API サービスの利用規約とデベロッパーポリシーの変更は、2020 年 1 月 10 日（太平洋時間）に有効になります。

2019 年 9 月 10 日

YouTube で、および API レスポンスで、チャンネル登録者数を報告する方法が変更されたため、API リファレンスドキュメントが更新されました。この変更により、YouTube Data API サービスから返されるチャンネル登録者数は、チャンネル登録者数が 1,000 人を超える場合、小数点以下 3 桁に切り捨てられます。この変更は、channel リソースの statistics.subscriberCount プロパティに影響します。

注: この変更は、ユーザーが自分のチャンネルに関するデータの承認済みリクエストを送信した場合でも、このプロパティ値に影響します。チャンネル所有者は引き続き YouTube Studio で正確なチャンネル登録者数を確認できます。

たとえば、チャンネルのチャンネル登録者数が 123,456 人の場合、statistics.subscriberCount プロパティには値 123000 が含まれます。以下の表は、API レスポンスでのチャンネル登録者数の丸めと、一般公開されている他の YouTube ユーザーインターフェースでの省略表記の例を示しています。

チャンネル登録者数の例	YouTube Data API	一般公開されている YouTube UI
1,234	1230	1230
12,345	12300	1.23 万
123,456	123000	12.3万
1,234,567	1230000	123万
12,345,678	12300000	1230万
123,456,789	123000000	123M

2019 年 4 月 4 日

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

API リファレンスドキュメントが更新され、各メソッドの一般的なユースケースがよりわかりやすく説明されるようになりました。また、API Explorer ウィジェットを通じて、高品質の動的コードサンプルが提供されるようになりました。例については、channels.list メソッドのドキュメントをご覧ください。API メソッドを説明するページに、2 つの新しい要素が追加されました。
- API Explorer ウィジェットを使用すると、認可スコープを選択して、サンプルのパラメータとプロパティの値を入力し、実際の API リクエストを送信して実際の API レスポンスを確認できます。ウィジェットには、入力したスコープと値を使用して動的に更新される完全なコードサンプルを表示する全画面ビューもあります。
- [一般的なユースケース] セクションでは、ページで説明されているメソッドの一般的なユースケースについて説明します。たとえば、channels.list メソッドを呼び出して、特定のチャンネルに関するデータや、現在のユーザーのチャンネルに関するデータを取得できます。
  
  このセクションのリンクを使用して、ユースケースのサンプル値を API Explorer に入力したり、それらの値がすでに入力されたフルスクリーンの API Explorer を開いたりできます。これらの変更は、独自のアプリに実装しようとしているユースケースに直接適用できるコードサンプルを簡単に確認できるようにすることを目的としています。
現在、コードサンプルは Java、JavaScript、PHP、Python、curl でサポートされています。
コードサンプルツールも更新され、上記のすべての機能を備えた新しい UI が導入されました。このツールを使用すると、さまざまなメソッドのユースケースを調べたり、API Explorer に値を読み込んだり、API Explorer を全画面表示して Java、JavaScript、PHP、Python のコードサンプルを取得したりできます。

この変更に伴い、Java、JavaScript、PHP、Python で利用可能なコードサンプルが記載されていたページは削除されました。
Java、JavaScript、PHP、Python のクイックスタートガイドが更新されました。改訂版のガイドでは、API Explorer のコードサンプルを使用して、API キーを使用するサンプルと OAuth 2.0 クライアント ID を使用するサンプルを実行する方法について説明しています。

なお、上記の変更は、2017 年に API ドキュメントに追加されたインタラクティブツールに代わるものです。

2018 年 7 月 9 日

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

channel リソースの snippet.thumbnails プロパティの定義が更新され、アプリでサムネイルを表示する場合、コードで API レスポンスで返された画像 URL をそのまま使用する必要があることに注意が追加されました。たとえば、API レスポンスで返された URL で、https ドメインの代わりに http ドメインを使用することはできません。

2018 年 7 月より、チャンネルサムネイルの URL は https ドメインでのみ使用できるようになります。この URL は、API レスポンスに表示されます。この期間を過ぎると、http ドメインから YouTube 画像を読み込もうとすると、アプリケーションに破損した画像が表示されることがあります。
注: これは非推奨のお知らせです。

video リソースの recordingDetails.location.altitude プロパティは非推奨になりました。動画がこのプロパティの値を返す保証はありません。同様に、API リクエストでそのプロパティの値を設定しようとしても、受信データが保存されない可能性があります。

2018 年 6 月 22 日

実装ガイド（旧称: 実装と移行ガイド）が更新され、v2 API から v3 API への移行手順が削除されました。また、v3 API で非推奨となった機能（高く評価した動画など）の手順も削除されました。

2017 年 11 月 27 日

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

注: これは非推奨のお知らせです。

YouTube は、注目の動画機能と注目のウェブサイト機能のサポートを終了します。これらの機能は、API で channel リソースの invideoPromotion オブジェクトを介してサポートされています。そのため、そのオブジェクトとそのすべての子プロパティは非推奨になりました。

invideoPromotion データの取得と設定は 2017 年 12 月 14 日まで可能です。その日以降は、次のようになります。
- channels.list の呼び出し時に invideoPromotion 部分を取得しようとすると、空の invideoPromotion が返されるか、invideoPromotion データがまったく返されなくなります。
- channels.update の呼び出し時に invideoPromotion データを更新しようとすると、2018 年 5 月 27 日までは成功レスポンスが返されますが、no-op として扱われ、実際には更新は行われません。
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. 対話型コードスニペットツールまたは API メソッド（channels.list メソッドなど）のドキュメントに移動します。
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 のインタラクティブなコードスニペットツールに、ツールの機能の一部を説明するドキュメントが追加されました。
- API リクエストの実行
- コードスニペットと完全なコードサンプルの切り替え
- ボイラープレート関数の使用
- 既存のリソースの読み込み（更新メソッドの場合）
注: このツールは、API メソッドの API リファレンスドキュメントにも埋め込まれています（例）。

2017 年 6 月 1 日

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

注: これは非推奨のお知らせです。

次の video リソースプロパティは非推奨になります。これらのプロパティは 2017 年 12 月 1 日までサポートされますが、それまで動画でこれらのプロパティの値が返されるとは限りません。同様に、これらのプロパティ値を設定する videos.insert リクエストと videos.update リクエストは、その日付より前にエラーを生成しませんが、受信データが保存されない可能性があります。

2017 年 5 月 17 日

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

API リファレンスドキュメントを更新し、コードスニペットをより普遍的でインタラクティブなものにしました。channels.list や videos.rate などの API メソッドについて説明するページに、Java、JavaScript、PHP、Python、Ruby、Apps Script、Go のコードスニペットを表示してカスタマイズできるインタラクティブなツールが追加されました。

特定のメソッドに対して、1 つ以上のユースケースのコードスニペットがツールに表示されます。各ユースケースは、そのメソッドを呼び出す一般的な方法を記述しています。たとえば、channels.list メソッドを呼び出して、特定のチャンネルまたは現在のユーザーのチャンネルに関するデータを取得できます。

コードサンプルを操作することもできます。
- パラメータとプロパティの値を変更すると、指定した値を反映してコードスニペットが動的に更新されます。
- コードスニペットと完全なサンプルを切り替えます。コードスニペットは、API メソッドを呼び出すコードの部分を示しています。完全なサンプルには、そのスニペットと、リクエストの承認と送信用のボイラープレートコードが含まれています。完全なサンプルは、コマンドラインまたはローカルウェブサーバーからコピーして実行できます。
- ボタンをクリックしてリクエストを実行します。（リクエストを実行するには、ユーザーに代わって API を呼び出すようにツールを承認する必要があります）。
このツールは、利用可能なページで API Explorer に代わるものです。（各ページにはリンクが表示されるため、作業中のリクエストを API Explorer に読み込むこともできます）。
Data API コードスニペットツールも更新され、上記のすべての機能を備えた新しい UI が導入されました。このページで利用できる主な新機能は次のとおりです。
- データを書き込む API リクエストのサポート。
- Java サンプルのサポート。
- ユーザーの認可と API リクエストの作成のための、より柔軟で包括的なボイラープレートコード。

2017 年 4 月 27 日

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

新しいクイックスタートガイドでは、YouTube Data API リクエストを行うシンプルなアプリケーションを設定する方法について説明します。現在、Android、Apps Script、Go、Java、JavaScript、Node.js、PHP、Python、Ruby のガイドを利用できます。

2017 年 3 月 30 日

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

channel リソースの新しい topicDetails.topicCategories[] プロパティには、チャンネルのコンテンツを説明するウィキペディアの URL のリストが含まれています。URL は、リソースの topicDetails.topicIds[] プロパティで返されたトピック ID に対応しています。
playlistItem リソースの新しい contentDetails.videoPublishedAt プロパティは、動画が YouTube に公開された時刻を識別します。リソースにはすでに snippet.publishedAt プロパティが含まれています。これは、アイテムがプレイリストに追加された時刻を識別します。
channel リソースと同様に、video リソースも topicDetails.topicCategories[] プロパティを返すようになりました。このプロパティには、動画のコンテンツを説明するウィキペディアの URL のリストが含まれます。video リソースの場合、URL はリソースの topicDetails.relevantTopicIds[] プロパティで返されるトピック ID に対応しています。
video リソースの新しい contentDetails.contentRating.mpaatRating プロパティは、Motion Picture Association of America が映画の予告編またはプレビューに付けたレーティングを識別します。

2017 年 2 月 27 日

2016 年 8 月 11 日に発表されたとおり、YouTube はサポートされているトピック ID のリストを厳選されたリストに切り替えました。サポートされているトピック ID の完全なリストは、channel リソースと video リソースの topicDetails プロパティ、および search.list メソッドの topicId パラメータに含まれています。

なお、キュレートされたリストにはいくつかの変更が加えられています。

次のトピックが Society のサブトピックとして追加されました。

名前トピック ID

Business /m/09s1f

健康 /m/0kt51

軍事 /m/01h6rj

政治 /m/05qt0

宗教 /m/06bvp
Entertainment の子だった Animated cartoon トピックが削除されました。
Music の子だった Children's music トピックが削除されました。

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

この変更により、動画に関連するトピックは常に video リソースの topicDetails.relevantTopicIds[] プロパティ値で返されるようになりました。

2016 年 11 月 29 日

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

2017 年 2 月 10 日よりサポートされるトピック ID のリストに、以下の 3 つの変更が加えられます。
- Professional wrestling カテゴリは、以前は Sports カテゴリの子でしたが、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 トピックを使用した検索ガイドはドキュメントから削除されました。このガイドでは、アプリケーションが Freebase API とどのように連携するかを示すコードサンプルが提供されています。

また、トピック ID に関連するいくつかのコードサンプルが、search.list メソッドのドキュメントから削除されました。

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 リソースの説明が更新され、チャンネルでターゲティングデータを設定せずに作成できるセクションは最大 10 個、ターゲティングデータを使用して作成できるセクションは最大 100 個であることが明記されました。
  
  また、ターゲティングオプションは API を使用してのみ設定できることを反映するため、channelSection リソースの targeting プロパティが更新されました。YouTube ウェブサイトのユーザーインターフェースを使用してチャンネルセクションを変更すると、ターゲティングオプションは削除されます。
- i18nLanguage リソースの snippet.name プロパティの定義を修正し、値が i18nLanguage.list メソッドの hl パラメータで指定された言語で記述された言語名を表すことを反映しました。
- playlistItem リソースの contentDetails.note プロパティが更新され、プロパティ値の最大長が 280 文字であることが明記されました。
- playlistItem リソースの contentDetails.startAt プロパティと contentDetails.endAt プロパティは非推奨になりました。これらのフィールドが playlistItems.insert リクエストまたは playlistItems.update リクエストで設定されている場合、これらのフィールドは無視されます。
- playlistItems.delete メソッドと playlistItems.update メソッドが、他のいくつかのメソッドですでにサポートされている onBehalfOfContentOwner パラメータをサポートするようになりました。このメソッドを使用するリクエストは、https://www.googleapis.com/auth/youtubepartner スコープへのアクセス権を提供するトークンによって承認される必要があります。
- search.list メソッドの publishedBefore パラメータと publishedAfter パラメータの両方が更新され、パラメータ値が両端を含むことを示しています。たとえば、publishedBefore パラメータが設定されている場合、API は指定された時刻の前または時刻に作成されたリソースを返します。
- video リソースの contentDetails.contentRating.grfilmRating プロパティは、grfilmK12、grfilmK15、grfilmK18 の 3 つの値もサポートしています。
- アップロードする動画の最大ファイルサイズが 64 GB から 128 GB に引き上げられたことを明記するため、videos.insert メソッドの説明を更新しました。

新しいエラーと更新されたエラー

この API は、次の新しいエラーをサポートしています。

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`homeParameterDeprecated`	`activities.list` メソッドは、この API ではユーザーのホームページアクティビティデータを利用できないことを示すために、このエラーを返します。このエラーは、未承認のリクエストで `home` パラメータを `true` に設定した場合に発生することがあります。
`invalidValue (400)`	`invalidContentDetails`	`playlistItems.insert` メソッドは、リクエスト内の `contentDetails` オブジェクトが無効であることを示すために、このエラーを返します。このエラーが発生する理由の一つは、`contentDetails.note` フィールドが 280 文字を超えていることです。
`forbidden (403)`	`watchHistoryNotAccessible`	`playlistItems.list` メソッドは、リクエストで「再生履歴」プレイリストアイテムの取得が試みられたが、API を使用して取得できないことを示すエラーを返します。
`forbidden (403)`	`watchLaterNotAccessible`	`playlistItems.list` メソッドは、リクエストで「後で見る」再生リストのアイテムを取得しようとしたが、API を使用して取得できないことを示すエラーを返します。
`badRequest (400)`	`uploadLimitExceeded`	`videos.insert` メソッドは、チャンネルでアップロードできる動画数が上限を超えたことを示すエラーを返します。
`forbidden (403)`	`forbiddenEmbedSetting`	`videos.update` メソッドは、API リクエストが動画に無効な埋め込み設定を設定しようとしていることを示すために、このエラーを返します。一部のチャンネルでは、ライブ配信の埋め込みプレーヤーを提供するための権限がない場合があります。詳しくは、YouTube ヘルプセンターをご覧ください。

playlistItems.insert メソッドは、重複する動画をプレイリストに挿入してもエラーを返さなくなりました。このエラーは、以前は、重複が許可されなかったが現在はサポートされていない一部の再生リスト（お気に入りの動画など）で発生していました。通常、再生リストには重複する動画を含めることができます。

その他の最新情報
- 2016 年 9 月 15 日の変更履歴エントリを更新し、channel リソースの contentDetails.relatedPlaylists.watchHistory プロパティと contentDetails.relatedPlaylists.watchLater プロパティがレスポンスに含まれる場合、常にそれぞれ HL と WL の値が含まれることを明確にしました。また、これらのプロパティは、承認されたユーザーが自分のチャンネルに関するデータを取得している場合にのみ含まれます。

2016 年 9 月 15 日

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

2016 年 8 月 11 日のリビジョン履歴の更新では、サポートされるトピック ID のセットが 2017 年 2 月 10 日に変更されることなど、トピック ID に関連するいくつかの変更について説明しました。サポートされるトピックのリストは 2016 年 11 月 10 日までに公開されます。
以下の変更が適用されました。これらの変更に関するお知らせは、2016 年 8 月 11 日の改訂履歴の更新で行われました。
- home パラメータを true に設定して activities.list メソッドを呼び出すと、API レスポンスに、ログアウトした YouTube ユーザーのホームページに表示される項目と同様の項目が含まれるようになりました。
  これは、2016 年 8 月 11 日のリビジョン履歴の更新で説明されている動作よりも優れたユーザーエクスペリエンスを提供することを目的とした、わずかな変更です。その更新では、home パラメータを使用するリクエストで空のリストが返されると記載されていました。
- channel リソースの contentDetails.relatedPlaylists.watchHistory プロパティと contentDetails.relatedPlaylists.watchLater プロパティに、すべてのチャンネルでそれぞれ HL と WL の値が含まれるようになりました。
  
  なお、これらのプロパティは、ユーザー自身のチャンネルに関するデータを取得する承認済みユーザーにのみ表示されます。承認済みのユーザーが自分のチャンネルに関するデータを取得する場合でも、プロパティには常に HL と WL の値が含まれます。そのため、視聴履歴と [後で見る] 再生リストの ID は API 経由で取得できません。
  
  また、チャンネルの再生履歴または [後で見る] 再生リストの再生リストの詳細（playlists.list）または再生リストのアイテム（playlistItems.list）を取得するリクエストは、空のリストが返されるようになりました。この動作は、新しい値 HL と WL だけでなく、API クライアントがすでに保存している再生履歴や後で見るプレイリスト ID にも適用されます。
video リソースの fileDetails.recordingLocation オブジェクトとその子プロパティは返されなくなりました。これまで、このデータ（親の fileDetails オブジェクトなど）は、動画のオーナーのみが取得できました。

2016 年 8 月 11 日

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

新しく公開された YouTube API サービスの利用規約（「更新された利用規約」）は、YouTube エンジニアリングとデベロッパーの Blog で詳しく説明されていますが、現在の利用規約の多くの更新が含まれています。2017 年 2 月 10 日に発効する利用規約の改定に加えて、デベロッパーが遵守すべきポリシーを説明する補足ドキュメントがいくつか追加されています。

新しいドキュメントの全文については、更新された利用規約の変更履歴をご覧ください。また、更新された利用規約やその補足書類の今後の変更についても、その変更履歴で説明されます。ドキュメント内のリンクから、その変更履歴の変更を示す RSS フィードを購読できます。
Freebase と Freebase API の非推奨化に伴い、トピック ID に関連するいくつかの変更が行われます。トピック ID は、次の API リソースとメソッドで使用されます。
- channel リソースの topicDetails 部分は、チャンネルに関連付けられたトピックを識別します。
- video リソースの topicDetails 部分は、動画に関連付けられているトピックを識別します。
- search.list メソッドの topicId パラメータを使用すると、特定のトピックに関連する動画やチャンネルを検索できます。
これらの機能の変更点は次のとおりです。
- 2017 年 2 月 10 日より、これまで返されていたよりきめ細かい ID セットではなく、少数のトピック ID セットが返されるようになります。サポートされているトピックのセットは、スポーツやバスケットボールなどの上位カテゴリを特定しますが、特定のチームや選手は特定しません。サポートされるトピックのセットについては、この変更に備えて申請を準備できるよう、お知らせいたします。
- すでに取得した Freebase トピック ID は、2017 年 2 月 10 日までコンテンツの検索に使用できます。ただし、それ以降は、前述の項目で特定したトピックのセットのみを使用して、トピック別の検索結果を取得できます。
- 2017 年 2 月 10 日以降、サポートされているトピック ID の限定セットに含まれないトピック ID を使用して結果を検索しようとすると、API は空の結果セットを返します。
2016 年 9 月 12 日より、以下の API フィールドとパラメータが非推奨になります。
- 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 にも当てはまります。
- video リソースの fileDetails.recordingLocation オブジェクトまたはその子プロパティは、2016 年 9 月 12 日以降は返されなくなります。親の fileDetails オブジェクトを取得できるのは動画の所有者のみであるため、このデータを取得できるのは動画の所有者に限られます。

2016 年 6 月 13 日

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

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

非推奨化後はどちらのプロパティも返されなくなるため、両方のプロパティは対応するリソースのドキュメントから削除されました。

2016 年 5 月 31 日

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

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

新しいパラメータでは、認証済みユーザーのチャンネルの最新のチャンネル登録者 1,000 人の取得のみがサポートされます。サブスクライバーの完全なリストを取得するには、mySubscribers パラメータを使用します。このパラメータは、サブスクライバーを特定の順序で返すわけではなく、取得できるサブスクライバーの数に制限はありません。
snippet.thumbnails.(key) プロパティの定義が、activity、playlistItem、playlist、search result、thumbnail、video リソースで更新され、一部の動画で追加のサムネイル画像サイズが使用可能であることが明記されました。
- standard 画像の幅は 640 ピクセル、高さは 480 ピクセルです。
- maxres 画像の幅は 1,280 ピクセル、高さは 720 ピクセルです。
channelSection.list メソッドの part パラメータの定義を更新し、targeting 部分は 2 割り当て単位の費用で取得できることを明記しました。
不適切に承認されたリクエストが 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 が含まれ、フェッチできない可能性があることが明記されました。これは、お気に入りの動画機能のサポートがすでに終了しているためです。このプロパティは、API 非推奨ポリシーの対象外です。
comments.insert、comments.update、commentThreads.insert、commentThreads.update メソッドによって返される ineligibleAccount エラーの定義が更新され、API リクエストの承認に使用された YouTube アカウントがユーザーの Google アカウントと統合されていない場合にエラーが発生することが反映されました。

2016 年 4 月 20 日

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

channels.update メソッドの part パラメータの定義を更新し、localizations もそのパラメータの有効な値であることを明記しました。
スタートガイドの割り当ての使用量セクションを更新し、実際の割り当てと割り当ての使用量を確認できる Google Developer Console へのリンクを追加しました。

2016 年 3 月 16 日

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

既存のリソースとメソッドの更新
- channelBanner リソースのドキュメントが更新され、アップロードするチャンネルバナー画像の推奨サイズが 2,560 x 1,440 ピクセルに変更されました。最小サイズ（2,048 x 1,152 ピクセル）は変更されていません。
- channel リソースの新しい snippet.customUrl プロパティは、チャンネルに関連付けられたカスタム URL を識別します。（すべてのチャンネルにカスタム URL があるわけではありません）。YouTube ヘルプセンターでは、カスタム URL の利用資格要件と URL の設定方法について説明しています。
- channel リソースの brandingSettings.watch オブジェクトとそのすべての子プロパティは非推奨になりました。
- search.list リクエストに対する API レスポンスに regionCode プロパティが含まれるようになりました。このプロパティは、検索クエリに使用された地域コードを識別します。地域コードは、指定された国の検索結果を返すように API に指示します。
  プロパティ値は、地域を識別する 2 文字の ISO 国コードです。i18nRegions.list メソッドは、サポートされているリージョンのリストを返します。デフォルト値は US です。サポートされていないリージョンが指定されている場合でも、YouTube はデフォルト値ではなく別のリージョンを選択してクエリを処理することがあります。
- videoAbuseReportReason リソースの snippet.label プロパティと snippet.secondaryReasons[].label プロパティの定義が更新され、これらのプロパティに不正行為報告の理由のローカライズ済みラベルテキストが含まれていることが明記されました。
  
  さらに、videoAbuseReportReasons.list メソッドが hl パラメータをサポートするようになりました。このパラメータは、API レスポンスのラベルテキストに使用する言語を指定します。デフォルトのパラメータ値は en_US です。
- video リソースの新しい contentDetails.contentRating.ecbmctRating プロパティは、トルコの文化観光省評価分類委員会による動画のレーティングを識別します。
  
  また、他のレーティングシステムの API プロパティは、次の新しいプロパティ値をサポートしています。
  - contentDetails.contentRating.fpbRating（南アフリカ）
    評価: 10; プロパティ値: fpb10
  - contentDetails.contentRating.moctwRating（台湾）
    レーティング: R-12、プロパティ値: moctwR12
  - contentDetails.contentRating.moctwRating（台湾）
    レーティング: R-15、プロパティ値: moctwR15
- video リソースの liveStreamingDetails.activeLiveChatId プロパティには、動画に関連付けられているアクティブなチャットの ID が含まれます。このプロパティ値は、ライブ配信中の動画で、ライブチャットが有効になっている場合にのみ存在します。放送が終了し、ライブチャットが終了すると、動画に対してこのプロパティが返されることはありません。
- video リソースの status.rejectionReason プロパティは、新しいプロパティ値 legal をサポートしています。

この API は、次の新しいエラーをサポートしています。

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`notEditable`	`channelSections.insert`、`channelSections.update`、`channelSections.delete` メソッドは、指定されたチャンネルセクションを作成、更新、削除できないことを示すエラーを返します。
`badRequest (400)`	`styleRequired`	`channelSections.insert` メソッドと `channelSections.update` メソッドは、API リクエストで送信された `channelSection` リソースに `snippet.style` プロパティの値を指定する必要があることを示します。
`badRequest (400)`	`typeRequired`	`channelSections.insert` メソッドと `channelSections.update` メソッドは、API リクエストで送信された `channelSection` リソースに `snippet.type` プロパティの値を指定する必要があることを示します。
`badRequest (400)`	`processingFailure`	`commentThreads.list` メソッドは、API サーバーがリクエストを正常に処理できなかったことを示すために、このエラーを返します。これは一時的なエラーである可能性がありますが、通常はリクエストの入力が無効であることを示します。リクエスト本文の `commentThread` リソースの構造が有効であることを確認します。
`forbidden (403)`	`commentsDisabled`	`commentThreads.list` メソッドは、`videoId` パラメータで識別された動画でコメントが無効になっていることを示すために、このエラーを返します。
`badRequest (400)`	`commentTextTooLong`	`commentThreads.insert` メソッドは、挿入される `comment` リソースの `snippet.topLevelComment.snippet.textOriginal` プロパティに文字が多すぎることを示すために、このエラーを返します。
`invalidValue (400)`	`videoAlreadyInAnotherSeriesPlaylist`	`playlistItems.insert` メソッドは、再生リストに追加しようとしている動画がすでに別のシリーズリストに含まれていることを示すために、このエラーを返します。シリーズ再生リストについて詳しくは、YouTube ヘルプセンターをご覧ください。
`badRequest (400)`	`subscriptionForbidden`	`subscriptions.insert` メソッドは、定期購入の最大数に達した、または最近作成した定期購入が多すぎることを示すエラーを返します。後者の場合は、数時間後にリクエストを再試行できます。
`badRequest (400)`	`invalidCategoryId`	`videos.update` メソッドは、アップロードされた `video` リソースの `snippet.categoryId` プロパティで無効なカテゴリ ID が指定されていることを示すために、このエラーを返します。`videoCategories.list` メソッドを使用して、サポートされているカテゴリを取得します。
`badRequest (400)`	`invalidDescription`	`videos.update` メソッドは、アップロードされた `video` リソースの `snippet.description` プロパティで無効な値が指定されていることを示すために、このエラーを返します。
`badRequest (400)`	`invalidPublishAt`	`videos.update` メソッドは、アップロードされた `video` リソースの `status.publishAt` プロパティで無効なスケジュール設定された公開時間が指定されていることを示すために、このエラーを返します。
`badRequest (400)`	`invalidRecordingDetails`	`videos.update` メソッドは、アップロードされた `video` リソースの `recordingDetails` オブジェクトで無効な録画の詳細が指定されていることを示すために、このエラーを返します。
`badRequest (400)`	`invalidTags`	`videos.update` メソッドは、アップロードされた `video` リソースの `snippet.tags` プロパティで無効な値が指定されていることを示すために、このエラーを返します。
`badRequest (400)`	`invalidTitle`	`videos.update` メソッドは、アップロードされた `video` リソースの `snippet.title` プロパティで無効な動画タイトルまたは空の動画タイトルが指定されていることを示すために、このエラーを返します。
`badRequest (400)`	`invalidVideoMetadata`	`videos.update` メソッドは、リクエストメタデータが無効であることを示すためにこのエラーを返します。このエラーは、リクエストで `video` リソースの `snippet` 部分が更新されたものの、`snippet.title` プロパティと `snippet.categoryId` プロパティの両方に値が設定されていない場合に発生します。

2015 年 12 月 18 日

欧州連合（EU）の法律では、EU のエンドユーザーに対して特定の情報を開示し、同意を得ることが義務付けられています。そのため、欧州連合（EU）のエンドユーザーに対しては、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`	このエラーは、リソースの `localizations` オブジェクトを挿入または更新しようとするリクエストが、そのリソースに `snippet.defaultLanguage` プロパティが設定されていないために失敗したことを示します。このエラーは、`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 プロパティには、フランスの Commission de classification cinematographique による動画のレーティングを指定します。このプロパティは、非推奨となった contentDetails.contentRating.fmocRating プロパティに代わるものです。
- channel リソースの brandingSettings.channel.keywords の定義が更新され、プロパティ値にカンマ区切りのリストではなく、スペース区切りの文字列のリストが含まれていることが正しく反映されるようになりました。この更新によって API の動作が変更されることはありません。
- thumbnails.set メソッドのドキュメントを更新し、リクエストの本文に、アップロードして動画に関連付けるサムネイル画像が含まれていることを正確に反映しました。リクエストの本文に thumbnail リソースが含まれていません。以前のドキュメントでは、このメソッドを呼び出すときにリクエスト本文を指定しないように記載されていました。この更新によって API の動作が変更されることはありません。
- activity リソースの説明を更新し、activities.list メソッドに現在、新しい動画コメントに関連するリソースが含まれていないことを反映しました。リソースの snippet.type と contentDetails.comment も更新されています。

新しいエラーと更新されたエラー

この API は、次のエラーをサポートするようになりました。

エラーの詳細

activities.insert

HTTP レスポンスコード	`badRequest (400)`
理由	`invalidMetadata`
説明	`kind` プロパティが指定された ID のタイプと一致しません。

commentThreads.update
comments.insert
comments.update

HTTP レスポンスコード	`badRequest (400)`
理由	`commentTextTooLong`
説明	挿入または更新される `comment` リソースの `snippet.topLevelComment.snippet.textOriginal` プロパティに文字が多すぎます。

playlistItems.insert
playlistItems.update

HTTP レスポンスコード	`forbidden (403)`
理由	`playlistItemsNotAccessible`
説明	指定された再生リストのアイテムを挿入、更新、削除する権限がリクエストに適切に付与されていません。

playlists.delete
playlists.insert
playlists.update

HTTP レスポンスコード	`badRequest (400)`
理由	`playlistForbidden`
説明	このオペレーションは禁止されているか、リクエストが適切に承認されていません。

search.list

HTTP レスポンスコード	`badRequest (400)`
理由	`invalidLocation`
説明	`location` パラメータまたは `locationRadius` パラメータの値の形式が正しくありません。

search.list

HTTP レスポンスコード	`badRequest (400)`
理由	`invalidRelevanceLanguage`
説明	`relevanceLanguage` パラメータ値の形式が正しくありません。

subscriptions.insert

HTTP レスポンスコード	`badRequest (400)`
理由	`subscriptionForbidden`
説明	このエラーは、次のいずれかに該当する場合に発生します。作成しようとしている定期購入はすでに存在しています定期購入の数が上限に達しているご自身のチャンネルを登録しようとしていますが、これはサポートされていません。最近作成した定期購入が多すぎます。リクエストを再試行するには、数時間待つ必要があります。

videos.update

HTTP レスポンスコード	`badRequest (400)`
理由	`invalidDefaultBroadcastPrivacySetting`
説明	リクエストで、デフォルトのブロードキャストに対して無効なプライバシー設定を設定しようとしています。

2015 年 8 月 28 日

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

既存のリソースとメソッドの更新
- video リソースの statistics.favoriteCount プロパティは非推奨になりました。
  
  非推奨ポリシーに従い、このプロパティは、このお知らせから少なくとも 1 年間は video リソースに引き続き含まれます。ただし、プロパティ値は常に 0 に設定されるようになりました。

2015 年 8 月 7 日

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

既存のリソースとメソッドの更新
- video リソースの snippet.tags[] プロパティの定義を更新し、API サーバーがプロパティの値の長さを計算する方法について詳しく説明しました。この更新は、API の動作の変更を反映するものではありません。
  
  具体的には、タグにスペースが含まれている場合、API サーバーはタグ値を引用符で囲んだものとして処理し、引用符は文字数にカウントされることが定義に明記されました。したがって、文字数制限の観点から、タグ Foo-Baz は 7 文字ですが、タグ Foo Baz は 9 文字になります。
- commentThreads.insert メソッドで shareOnGooglePlus パラメータがサポートされなくなりました。このパラメータは、コメントとそのコメントへの返信を投稿者の Google+ プロフィールにも投稿するかどうかを指定していました。リクエストでパラメータが送信された場合、API サーバーはパラメータを無視しますが、それ以外の場合はリクエストを処理します。

2015 年 6 月 18 日

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

既存のリソースとメソッドの更新
- commentThreads.list メソッドの新しい order パラメータは、API レスポンスでコメントスレッドを一覧表示する順序を指定します。スレッドは時間または関連性で並べ替えることができます。デフォルトでは、時系列順に並べられます。
- video リソースの新しい snippet.defaultAudioLanguage プロパティは、動画のデフォルトの音声トラックで使用される言語を指定します。
- video リソースの contentDetails.licensedContent プロパティの定義が更新され、コンテンツは YouTube コンテンツパートナーにリンクされたチャンネルに最初にアップロードされ、そのパートナーによって申し立てが行われたものでなければならないことが明確になりました。これは実際の API の動作の変更を意味するものではありません。
- captions.delete、captions.download、captions.insert、captions.list、captions.update の各メソッドで、onBehalfOfContentOwner パラメータがサポートされるようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。このメソッドを使用するリクエストは、https://www.googleapis.com/auth/youtubepartner スコープへのアクセス権を提供するトークンによって承認される必要があります。

新しいエラーと更新されたエラー

この API は、次のエラーをサポートするようになりました。

エラーの詳細

videos.rate

HTTP レスポンスコード	`badRequest (400)`
理由	`emailNotVerified`
説明	ユーザーは動画に評価を付ける前に、メールアドレスを確認する必要があります。

videos.rate

HTTP レスポンスコード	`badRequest (400)`
理由	`videoPurchaseRequired`
説明	レンタル動画の評価を行えるのは、その動画をレンタルしたユーザーのみです。

subscriptions.delete メソッドと subscriptions.insert メソッドは、accountClosed エラーと accountSuspended エラーをサポートしなくなりました。

2015 年 4 月 27 日

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

新しいリソースとメソッド
- 新しい videoAbuseReportReason リソースには、動画に不適切なコンテンツが含まれていると報告された理由に関する情報が含まれます。videoAbuseReportReasons.list メソッドを使用すると、動画が報告される可能性があるすべての理由のリストを取得できます。
- 新しい videos.reportAbuse メソッドでは、不適切なコンテンツを含む動画に実際に報告できます。リクエストの本文には、報告対象の動画と、動画に不適切なコンテンツが含まれていると判断された理由を指定する JSON オブジェクトが含まれます。有効な理由は、上記の videoAbuseReportReason.list メソッドから取得できます。
  
  また、移行ガイドも更新され、不正な動画を報告する例が追加されました。この変更により、v3 API はサポートが予定されている v2 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`	`snippet.parentId` プロパティで識別されたトップレベルコメントへの返信として、API ユーザーがコメントを挿入できない場合、`comments.insert` メソッドはこのエラーを返します。`commentThread` リソースの `snippet.canReply` プロパティは、現在の視聴者がスレッドに返信できるかどうかを示します。
`badRequest (400)`	`invalidChannelId`	リクエストの `channelId` パラメータで無効なチャンネル ID が指定されている場合、`search.list` メソッドはこのエラーを返します。
`badRequest (400)`	`subscriptionForbidden`	API ユーザーが自分のチャンネルを登録しようとすると、`subscriptions.insert` メソッドはこのエラーを返します。

captions.update メソッドは、invalidMetadata エラーと videoNotFound エラーをサポートしなくなりました。

2015 年 4 月 16 日

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

移行ガイドが更新され、v2 API のコメント機能をまだ使用しているアプリを移行する方法が説明されました。

また、v2 API ではサポートされていなかったが、v3 API でサポートされているコメント機能についても説明しています。たとえば、次のような問題があります。
- チャンネルに関するコメントの取得
- チャンネルに関連するすべてのコメントスレッドを取得します。つまり、API レスポンスには、チャンネルまたはその動画に関するコメントが含まれる可能性があります。
- コメントのテキストを更新する
- コメントをスパムとしてマークする
- コメントの管理ステータスの設定
プッシュ通知の登録ガイドが更新され、通知が Google PubSubHubBub ハブにのみプッシュされ、以前に記載されていたように Superfeedr ハブにはプッシュされないという点が反映されました。

2015 年 4 月 9 日

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

API の新しい commentThread リソースと comment リソースを使用すると、コメントの取得、挿入、更新、削除、管理を行うことができます。
- commentThread リソースには、YouTube コメントスレッドに関する情報が含まれます。このスレッドは、最上位のコメントと、そのコメントへの返信（存在する場合）で構成されます。commentThread リソースは、動画またはチャンネルに関するコメントを表すことができます。
  
  最上位のコメントと返信は、実際には commentThread リソース内にネストされた comment リソースです。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 メソッドを呼び出すには、2015 年 4 月 2 日の変更履歴で説明されている API の新しい https://www.googleapis.com/auth/youtube.force-ssl スコープが必要です。
新しいプッシュ通知の定期購入ガイドでは、ウェブにアクセス可能なリソースのサーバー間パブリッシュ/サブスクライブプロトコルである 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 スコープでは、API サーバーとの通信が SSL 接続を介して行われることが求められます。

この新しいスコープは、https://www.googleapis.com/auth/youtube スコープと同じアクセス権を付与します。実際、YouTube API サーバーは HTTPS エンドポイント経由でのみ利用できるため、これらの 2 つのスコープは機能的に同じです。そのため、https://www.googleapis.com/auth/youtube スコープで SSL 接続が不要であっても、実際には API リクエストを行う方法が他にありません。

新しいスコープは、caption リソースのすべてのメソッドの呼び出しに必要です。

2015 年 3 月 11 日

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

YouTube Data API（v3）移行ガイドに、v3 API の新機能という新しいタブが追加されました。このタブには、v3 API でサポートされているが v2 API ではサポートされていない機能がリストされています。同じ機能は、以前も、現在も、ガイドの他のタブに記載されています。たとえば、チャンネルの動画内プロモーションキャンペーンデータを更新する方法について説明する新しい機能も、[チャンネル（プロフィール）] タブに表示されます。
YouTube Data API（v3）移行ガイドが更新され、v3 API が次の v2 API 機能をサポートすることが記載されました。
- 動画の報告
YouTube Data API（v3）移行ガイドが更新され、v2 API の次の機能は v3 API でサポートされないことが明記されました。
- 動画のおすすめを取得する - v3 API は、現在の API ユーザーにおすすめの動画のみを含むリストを取得しません。ただし、v3 API を使用しておすすめの動画を検索するには、activities.list メソッドを呼び出し、home パラメータの値を true に設定します。
  
  API レスポンスで、snippet.type プロパティの値が recommendation の場合、リソースはおすすめの動画に対応します。その場合、contentDetails.recommendation.reason プロパティと contentDetails.recommendation.seedResourceId プロパティには、動画がおすすめされた理由に関する情報が含まれます。レスポンスに特定の数のおすすめ動画が含まれる保証はありません。
- チャンネルの候補を取得する
- 新しい登録動画を取得する - v3 API は、API ユーザーが登録しているチャンネルに最近アップロードされた動画のみを含むリストを取得しません。ただし、v3 API を使用して、activities.list メソッドを呼び出し、home パラメータの値を true に設定することで、新しい定期購入動画を見つけることができます。
  
  API レスポンスで、snippet.type プロパティの値が upload の場合、リソースは新しい定期購入動画に対応します。レスポンスに特定の数の新しい登録チャンネル動画が含まれる保証はありません。
- RSS フィードのサポート
- フィードの更新に関するプッシュ通知 - v2 API は、Simple Update Protocol（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 でサポートされていたバッチ処理のユースケースの 1 つをサポートしています。v3 API の channels.list、channelSections.list、guideCategories.list、playlistItems.list、playlists.list、subscriptions.list、videoCategories.list、videos.list メソッドはすべて id パラメータをサポートしています。このパラメータを使用すると、ID（動画 ID、チャンネル ID など）のカンマ区切りリストを指定できます。これらのメソッドを使用すると、1 つのリクエストで複数のリソースのリストを取得できます。
これらの変更により、古い（v2）API でサポートされていたが、現在の API バージョン（v3）で非推奨となるすべての機能がガイドに記載されるようになりました。

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 メソッドを呼び出し、playlistId パラメータをキャプチャした ID に、part パラメータを snippet に設定します。

2014 年 10 月 8 日

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

channel リソースには、次の 2 つの新しいプロパティが含まれています。
- status.longUploadsStatus プロパティは、チャンネルが 15 分を超える動画をアップロードできるかどうかを示します。このプロパティは、チャンネル所有者が API リクエストを承認した場合にのみ返されます。有効なプロパティ値は以下のとおりです。
  - allowed - チャンネルは 15 分を超える動画をアップロードできます。
  - eligible - チャンネルは 15 分を超える動画をアップロードできますが、まずこの機能を有効にする必要があります。
  - disallowed - チャンネルは 15 分を超える動画をアップロードできないか、アップロードする資格がありません。
  これらの値の詳細については、プロパティの定義をご覧ください。YouTube ヘルプセンターでも、この機能について詳しく説明しています。
- invideoPromotion.useSmartTiming プロパティは、チャンネルのプロモーションキャンペーンで「スマートタイミング」が使用されているかどうかを示します。この機能は、クリックされる可能性が高い一方で、視聴体験を妨げにくい動画のタイミングでプロモーションを表示しようとします。また、この機能では、各動画に 1 つのプロモーションを表示します。
video リソースの snippet.title プロパティと snippet.categoryId プロパティの定義が更新され、API が videos.update メソッドの呼び出しを処理する方法が明確になりました。このメソッドを呼び出して video リソースの snippet 部分を更新する場合は、両方のプロパティに値を設定する必要があります。

video リソースの snippet 部分を更新しようとしたときに、これらのプロパティの両方に値を設定していない場合、API は invalidRequest エラーを返します。このエラーの説明も更新されています。
ニュージーランドの映画・文学分類局による動画のレーティングを識別する video リソースの contentDetails.contentRating.oflcRating プロパティで、oflcRp13 と oflcRp16 の 2 つの新しいレーティングがサポートされるようになりました。これらは、それぞれ RP13 と RP16 の評価に対応しています。

channelBanners.insert メソッドで、次のエラーがサポートされるようになりました。

エラーのタイプ	エラーの詳細	説明
`badRequest`	`bannerAlbumFull`	チャンネル所有者の YouTube チャンネルアートアルバムに画像が多すぎます。チャンネル所有者は、http://photos.google.com にアクセスし、アルバムページに移動して、そのアルバムから画像を削除する必要があります。

2014 年 9 月 12 日

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

search.list メソッドの呼び出しの割り当て費用が、指定されたリソース部分の費用に加えて 1 ユニットから 2 ユニットに変更されました。

2014 年 8 月 13 日

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

subscriptions.insert メソッドで、次のエラーがサポートされるようになりました。

エラーのタイプ	エラーの詳細	説明
`badRequest`	`subscriptionLimitExceeded`	リクエストで識別された定期購入者が、定期購入のレート上限を超えています。数時間後にもう一度お試しください。

2014 年 8 月 12 日

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

新しいガイド「アプリケーションを YouTube Data API（v3）に移行する」では、YouTube Data API（v3）を使用して YouTube Data API（v2）で利用可能な機能を実行する方法について説明しています。古い API は、2014 年 3 月 4 日をもって正式に非推奨となりました。このガイドは、v2 API を引き続き使用しているアプリを最新の API バージョンに移行する際に役立つことを目的としています。

2014 年 7 月 8 日

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

playlists.insert メソッドで、次のエラーがサポートされるようになりました。

エラーのタイプ	エラーの詳細	説明
`badRequest`	`maxPlaylistExceeded`	このエラーは、チャンネルに許可されているプレイリストの最大数に達しているため、プレイリストを作成できない場合に発生します。

2014 年 6 月 18 日

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

各 API メソッドの説明が更新され、そのメソッドの呼び出しによって発生する割り当て費用が追加されました。同様に、part パラメータの定義が更新され、API 呼び出しで取得できる各部分の割り当て費用が指定されるようになりました。たとえば、subscriptions.insert メソッドの呼び出しでは、割り当て費用が約 50 ユニットになります。subscription リソースにも 3 つの部分（snippet、contentDetails、subscriberSnippet）があり、それぞれ 2 ユニットの費用がかかります。

割り当て費用は予告なく変更される場合があります。
video リソースで、43 の新しいコンテンツレーティングシステムがサポートされるようになりました。これらのシステムは、さまざまな国内レーティング機関から動画に割り当てられたレーティングを識別します。新たにサポートされるレーティングシステムは、アルゼンチン、オーストリア、ベルギー、ブルガリア、チリ（テレビ）、チリ（映画）、チェコ共和国、コロンビア、デンマーク、エジプト、エストニア、フィンランド、フランス、ギリシャ、香港、アイスランド、インドネシア、アイルランド、イスラエル、イタリア、ケニア、ラトビア、ルクセンブルク、マレーシア、モルディブ、マルタ、オランダ、ナイジェリア、ノルウェー、ペルー、フィリピン、ポルトガル、ルーマニア、シンガポール、スロバキア、南アフリカ、スウェーデン、スイス、台湾、タイ、ベネズエラです。

2014 年 5 月 28 日

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

search.list メソッドで location パラメータと locationRadius パラメータがサポートされるようになりました。これにより、地理的位置に関連付けられた動画を検索できるようになりました。位置情報に基づいて結果を取得するには、リクエストで両方のパラメータの値を指定する必要があります。リクエストに 2 つのパラメータのいずれか 1 つしか含まれていない場合、API からエラーが返されます。
- location パラメータは、円形の地理範囲の中心の緯度と経度の座標を指定します。
- locationRadius パラメータは、動画に関連付けられた場所が、検索結果に含まれる範囲の中心から離れている場合の最大距離を指定します。

2014 年 5 月 13 日

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

channel リソースの invideoPromotion.items[] プロパティが更新され、通常はチャンネルに設定できるプロモーション対象アイテムは 1 つのみであることが明記されました。プロモーション対象アイテムを挿入しようとすると、HTTP 400 ステータスコードを持つ tooManyPromotedItems エラーが API から返されます。
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 部分をサポートするようになりました。新しい部分には、チャンネルにリンクされている YouTube パートナーに関連するチャンネルデータが含まれます。これには、チャンネルにリンクされているコンテンツ所有者の ID や、コンテンツ所有者とチャンネルがリンクされた日時などが含まれます。この新しいパーツは非推奨ポリシーの対象外です。

ドキュメントに、次のプロパティでサポートされている最大文字数を記載しました。

リソース	プロパティ	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 またはプロモーション対象アイテムとして使用できない動画 ID が指定されている場合、`channels.update` メソッドはこのエラーを返します。
`forbidden (403)`	`websiteLinkNotAllowed`	`invideoPromotion.items[].id.websiteUrl` プロパティで許可されていない URL が指定されている場合、`channels.update` メソッドはこのエラーを返します。
`required (400)`	`requiredTimingType`	リクエストで、YouTube がプロモーション対象アイテムを表示するタイミングのデフォルトの設定が指定されていない場合、`channels.update` メソッドはこのエラーを返します。
`required (400)`	`requiredTiming`	`channels.update` メソッドでは、プロモーション対象アイテムごとに `invideoPromotion.items[].timing` オブジェクトを指定する必要があります。
`required (400)`	`requiredWebsiteUrl`	`channels.update` メソッドでは、プロモートされたアイテムごとに `invideoPromotion.items[].id.websiteUrl` プロパティを指定する必要があります。
`badRequest (400)`	`invalidPublishAt`	リクエストメタデータで無効なスケジュール設定された公開時間が指定されている場合、`videos.insert` メソッドはこのエラーを返します。

2014 年 3 月 4 日

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

YouTube Data API v3 には、YouTube API の利用規約に記載されている非推奨ポリシーが適用されるようになりました。非推奨ポリシーの対象となる API を示すページでは、一部の v3 API 機能がポリシーの対象から除外されています。

2013 年 12 月 5 日

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

検索リクエストを送信する際に、フィルタパラメータに 1 つ以上の値を指定する必要がないことを適切に反映するように、search.list メソッドのドキュメントが更新されました。代わりに、0 個または 1 個のフィルタパラメータに値を設定できます。
search.list メソッドのパラメータの定義が更新され、次のいずれかのパラメータの値も指定する場合は、type パラメータの値を video に設定する必要があることが明記されました。
- eventType
- videoCaption
- videoCategoryId
- videoDefinition
- videoDimension
- videoDuration
- videoEmbeddable
- videoLicense
- videoSyndicated
- videoType
アップロードするチャンネルバナー画像の最小サイズが 2,048 x 1,152 ピクセルに引き下げられました。（これまでの最小サイズは 2120 x 1192 ピクセルでした）。また、channel リソースのドキュメントには、API から配信されるすべてのバナー画像の最大サイズが記載されています。たとえば、テレビアプリケーションの brandingSettings.image.bannerTvImageUrl 画像の最大サイズは 2,120 x 1,192 ピクセルですが、実際の画像は 2,048 x 1,152 ピクセルになる場合があります。YouTube ヘルプセンターでは、さまざまな種類のデバイスでの表示に適したチャンネルアートを作成するためのガイダンスが提供されています。
次の情報を反映するように、いくつかの channel リソースプロパティの定義が更新されました。
- brandingSettings.channel.description プロパティの値の最大長は 1,000 文字です。
- brandingSettings.channel.featuredChannelsTitle プロパティの最大長は 30 文字です。
- brandingSettings.channel.featuredChannelsUrls[] プロパティで最大 100 個のチャンネルを一覧表示できるようになりました。
- brandingSettings.channel.unsubscribedTrailer プロパティ値を設定する場合は、チャンネル所有者が所有する公開動画または限定公開動画の YouTube 動画 ID を指定する必要があります。
channels.update メソッドで invideoPromotion.items[].promotedByContentOwner プロパティの更新がサポートされるようになりました。このプロパティは、プロモーションを表示する際にコンテンツ所有者の名前を表示するかどうかを示します。プロパティ値を設定する API リクエストが、onBehalfOfContentOwner パラメータを使用してコンテンツ所有者の代わりに実行されている場合にのみ設定できます。
playlistItems.list メソッドと playlistItems.insert メソッドが、他のいくつかのメソッドですでにサポートされている onBehalfOfContentOwner パラメータをサポートするようになりました。
contentDetails.contentRating.acbRating プロパティで、映画の場合はオーストラリア分類委員会（ACB）、子供向けテレビ番組の場合はオーストラリア通信メディア局（ACMA）のレーティングを指定できるようになりました。
新しい contentDetails.contentRating.catvRating プロパティと contentDetails.contentRating.catvfrRating プロパティは、カナダのテレビ分類システムと、ケベックで使用されているフランス語の Régie du cinéma レーティングシステムで動画に割り当てられたレーティングをそれぞれ識別します。
videoCategory リソースの新しい snippet.assignable プロパティは、更新された動画または新しくアップロードされた動画をその動画カテゴリに関連付けることができるかどうかを示します。
次のメソッドのコードサンプルが追加されました。
- activities.insert（Go）
- channelBanners.insert（Python）
- channels.update（Python）
- playlistItems.list（Go）
- search.list（Go）
- thumbnails.set（Java）
- videos.insert（Go）

2013 年 10 月 24 日

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

この API には、ライブ放送コンテンツを見つけて紹介するための 2 つの追加機能が含まれています。
検索結果の新しい snippet.liveBroadcastContent プロパティは、動画リソースまたはチャンネルリソースにライブ配信コンテンツがあるかどうかを示します。有効なプロパティ値は upcoming、active、none です。
- video リソースの新しい snippet.liveBroadcastContent プロパティは、動画が近日公開のライブ配信か、アクティブなライブ配信かを指定します。プロパティの有効な値は次のとおりです。
  - upcoming - 動画は、まだ開始されていないライブ放送です。
  - active - 動画は現在ライブ配信中です。
  - none - 動画は近日公開またはアクティブなライブ配信ではありません。これは、YouTube で引き続き視聴可能な、終了したブロードキャストのプロパティ値です。
- video リソースの新しい liveStreamingDetails プロパティは、ライブ動画配信に関するメタデータを含むオブジェクトです。このメタデータを取得するには、part パラメータ値のリソース部分のリストに liveStreamingDetails を含めます。メタデータには、次の新しいプロパティが含まれています。
  - liveStreamingDetails.actualStartTime - ブロードキャストの実質的な開始時間。（この値は、ブロードキャストの状態が active になると存在します）。
  - liveStreamingDetails.actualEndTime - ブロードキャストが実際に終了した時刻。（この値は、ブロードキャスト終了後に表示されます）。
  - liveStreamingDetails.scheduledStartTime - ブロードキャストの開始時刻。
  - liveStreamingDetails.scheduledEndTime - ブロードキャストの終了予定時刻。プロパティ値が空であるか、プロパティが存在しない場合、ブロードキャストは無期限に続行されるようにスケジュールされます。
  - liveStreamingDetails.concurrentViewers - ライブ配信を視聴している視聴者数。
  このメタデータを取得するには、videos.list メソッド、videos.insert メソッド、または videos.update メソッドを呼び出すときに、part パラメータ値に liveStreamingDetails を含めます。
2013 年 10 月 1 日には、ライブ放送コンテンツを識別するための 2 つの機能（search.list メソッドの eventType パラメータと検索結果の snippet.liveBroadcastContent プロパティ）もリリースされています。
videos.insert メソッドが notifySubscribers パラメータをサポートするようになりました。このパラメータは、動画のチャンネルを登録しているユーザーに新しい動画に関する通知を送信するかどうかを示します。このパラメータのデフォルト値は True で、新しくアップロードされた動画がチャンネル登録者に通知されます。ただし、多くの動画をアップロードしているチャンネル所有者は、新しい動画ごとにチャンネル登録者に通知が送信されないように、値を False に設定することをおすすめします。
channels.update メソッドの呼び出し時に変更できるプロパティのリストが更新され、invideoPromotion.items[].customMessage プロパティと invideoPromotion.items[].websiteUrl プロパティが追加されました。また、変更可能な brandingSettings プロパティを識別するようにリストが変更されました。これらの brandingSettings プロパティはすでに変更可能だったため、ドキュメントの変更は API の既存の機能の変更を反映していません。
playlists.insert、playlists.update、playlists.delete メソッドで、他のいくつかのメソッドですでにサポートされている onBehalfOfContentOwner パラメータがサポートされるようになりました。
playlists.insert メソッドが onBehalfOfContentOwnerChannel パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。
video リソースの contentDetails.contentRating.tvpgRating プロパティで、TV-14 評価に対応する pg14 の値がサポートされるようになりました。
検索結果の一部である snippet.liveBroadcastContent プロパティの定義を修正し、live は有効なプロパティ値であるが、active は有効なプロパティ値ではないことを反映しました。
video リソースの contentDetails.contentRating.mibacRating プロパティで、次の 2 つの評価がサポートされるようになりました。
- mibacVap（VAP） - 子どもは大人と一緒に参加する必要があります。
- mibacVm6（V.M.6）- 6 歳以上のみ可。
- mibacVm12（V.M.12）- 12 歳以上のみ可。
channel リソースの新しい invideoPromotion.items[].promotedByContentOwner プロパティは、プロモーションを表示する際にコンテンツ所有者の名前を表示するかどうかを示します。このフィールドを設定できるのは、値を設定する API リクエストがコンテンツ所有者の代理で実行されている場合のみです。詳細については、onBehalfOfContentOwner パラメータをご覧ください。

2013 年 10 月 1 日

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

channel リソースの新しい auditDetails オブジェクトには、マルチチャンネルネットワーク（MCN）が特定のチャンネルを承認または拒否するかどうかを判断する際に評価するチャンネルデータが含まれます。このリソース部分を取得する API リクエストには、https://www.googleapis.com/auth/youtubepartner-channel-audit スコープを含む認証トークンを提供する必要があります。また、そのスコープを使用するトークンは、MCN がチャンネルの承認または拒否を決定したとき、またはトークンが発行された日から 2 週間以内に取り消す必要があります。
channel リソースの invideoPromotion.items[].id.type プロパティが recentUpload の値をサポートするようになりました。これは、プロモーション対象のアイテムが指定されたチャンネルから最近アップロードされた動画であることを示します。

デフォルトでは、チャンネルは動画内プロモーションデータが設定されているチャンネルと同じです。ただし、新しい invideoPromotion.items[].id.recentlyUploadedBy プロパティの値をそのチャンネルのチャンネル ID に設定することで、別のチャンネルから最近アップロードされた動画を宣伝できます。
channel リソースには、テレビアプリのチャンネルページに表示されるバナー画像の URL を指定する 3 つの新しいプロパティ（brandingSettings.image.bannerTvLowImageUrl、brandingSettings.image.bannerTvMediumImageUrl、brandingSettings.image.bannerTvHighImageUrl）が追加されました。
検索結果の新しい snippet.liveBroadcastContent プロパティは、動画リソースまたはチャンネルリソースにライブ配信コンテンツがあるかどうかを示します。有効なプロパティ値は upcoming、active、none です。
- video リソースの場合、値 upcoming は動画がまだ開始されていないライブ配信であることを示します。値 active は、動画が進行中のライブ配信であることを示します。
- channel リソースの場合、値 upcoming は、チャンネルにまだ開始されていないスケジュール設定されたブロードキャストがあることを示します。値 acive は、チャンネルでライブ配信が進行中であることを示します。
watermark リソースの targetChannelId プロパティがオブジェクトから文字列に変更されました。ウォーターマーク画像がリンクするチャンネルの YouTube チャンネル ID を指定する子プロパティではなく、targetChannelId プロパティにその値自体を指定できるようになりました。これに伴い、リソースの targetChannelId.value プロパティは削除されました。
thumbnails.set メソッドが onBehalfOfContentOwner パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。
search.list メソッドで eventType パラメータがサポートされるようになりました。これにより、アクティブなブロードキャストイベント、今後のブロードキャストイベント、完了したブロードキャストイベントのみを返すように検索を制限できます。
新しい contentDetails.contentRating.mibacRating プロパティは、イタリアの Ministero dei Beni e delle Attivita Culturali e del Turismo から動画に付与されたレーティングを識別します。

この API は、次のエラーをサポートするようになりました。

エラーのタイプ	エラーの詳細	説明
`badRequest`	`invalidImage`	指定された画像コンテンツが無効な場合、`thumbnails.set` メソッドはこのエラーを返します。
`forbidden`	`videoRatingDisabled`	評価対象の動画の所有者がその動画の評価を無効にしている場合、`videos.rate` メソッドはこのエラーを返します。

2013 年 8 月 27 日

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

新しい watermark リソースは、指定したチャンネルの動画の再生中に表示される画像を識別します。画像のリンク先ターゲットチャンネルや、動画の再生中に透かしを表示するタイミングとその長さを指定することもできます。

watermarks.set メソッドは、チャンネルの透かし画像をアップロードして設定します。watermarks.unset メソッドは、チャンネルのウォーターマーク画像を削除します。

エラーのドキュメントには、API が watermarks.set メソッドと watermarks.unset メソッドで特にサポートするエラーメッセージが記載されています。
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 の AdWords ポリシー、YouTube 広告ポリシー、YouTube コミュニティガイドライン、YouTube 利用規約に準拠することを承諾したものとみなされます。
- 動画の再生中にプロモーション対象アイテムを表示するタイミングの設定に関連するプロパティが再構成されました。
  - invideoPromotion.timing オブジェクトは invideoPromotion.items[].timing に移動されました。このオブジェクトを使用すると、invideoPromotion.items[] リスト内のプロモーション対象アイテムのタイミングデータをカスタマイズできるようになりました。
  - 新しい invideoPromotion.defaultTiming オブジェクトには、プロモーションのデフォルトのタイミング設定を指定します。これらの設定では、チャンネルの動画の再生中にプロモーション対象アイテムを表示するタイミングを定義します。invideoPromotion.items[].timing オブジェクトを使用して、任意のプロモートアイテムのデフォルトのタイミングをオーバーライドできます。
  - 新しい invideoPromotion.items[].timing.durationMs プロパティでは、プロモーションを表示する時間をミリ秒単位で指定します。invideoPromotion.defaultTiming オブジェクトには、プロモーション対象アイテムを表示するデフォルトの時間を指定する durationMs フィールドも含まれています。
- invideoPromotion.items[].type プロパティと invideoPromotion.items[].videoId プロパティの両方が invideoPromotion.items[].id オブジェクトに移動されました。
subscriptions.list メソッドが onBehalfOfContentOwner パラメータと onBehalfOfContentOwnerChannel パラメータをサポートするようになりました。どちらのパラメータも、他のいくつかの方法ですでにサポートされています。
thumbnails.set リクエストに対する API レスポンスで、kind プロパティの値が youtube#thumbnailListResponse から youtube#thumbnailSetResponse に変更されました。
次のメソッドのコードサンプルが追加されました。
- channels.update（Java、Python）
- playlists.insert（.NET、PHP）
- subscriptions.insert（PHP、Python）
- thumbnails.set（PHP、Python）
- videos.insert（PHP）
- videos.list（PHP）
- videos.rate（Python）
- videos.update（Java、PHP、Python）
なお、playlistItems.insert メソッドの Python の例も削除されました。この例で説明されている機能は、videos.rate メソッドによって処理されるようになったためです。

error documentation は、mine リクエストパラメータをサポートする任意の API メソッドで発生する可能性のある、次の新しいリクエストコンテキストエラーを表します。

エラーのタイプ	エラーの詳細	説明
`badRequest`	`invalidMine`	`mine` パラメータは、認証されたユーザーが YouTube パートナーであるリクエストでは使用できません。`mine` パラメータを削除するか、`onBehalfOfContentOwner` パラメータを削除して YouTube ユーザーとして認証するか、呼び出されたメソッドで使用可能な場合は `onBehalfOfContentOwnerChannel` パラメータを指定してパートナーのチャンネルのいずれかとして動作する必要があります。

2013 年 8 月 8 日

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

YouTube Data API のスタートガイドの割り当ての使用量セクションが更新され、動画アップロードの割り当て費用が約 16,000 ユニットから約 1,600 ユニットに変更されました。

2013 年 7 月 30 日

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

channelBanner リソースで、kind プロパティの値が youtube#channelBannerInsertResponse から youtube#channelBannerResource に変更されました。このリソースは、channelBanners.insert リクエストに応答して返されます。
channel リソースの新しい brandingSettings.channel.profileColor プロパティでは、チャンネルのコンテンツを引き立たせる目立つ色を指定します。プロパティ値は、番号記号（#）に続いて 6 文字の 16 進数文字列（#2793e6 など）です。
API で、チャンネルのすべてのアクティビティを登録するか、新規アップロードのみを登録するかを指定できるようになりました。subscription リソースの新しい contentDetails.activityType プロパティは、サブスクライバーに通知されるアクティビティのタイプを識別します。有効なプロパティ値は all と uploads です。
videos.list メソッドは、YouTube で最も人気のある動画のチャートを取得するための新しいパラメータをサポートしています。
- chart パラメータは、取得するグラフを識別します。現在サポートされている値は mostPopular のみです。chart パラメータはフィルタパラメータであるため、他のフィルタパラメータ（id と myRating）と同じリクエストで使用することはできません。
- videoCategoryId パラメータは、グラフを取得する動画カテゴリを指定します。このパラメータは、chart パラメータと組み合わせてのみ使用できます。デフォルトでは、グラフは特定のカテゴリに制限されません。
video リソースの新しい topicDetails.relevantTopicIds[] プロパティには、動画またはそのコンテンツに関連する Freebase トピック ID のリストが指定されます。これらのトピックの対象が動画で言及されているか、動画に登場している可能性があります。
video リソースの recordingDetails.location.elevation プロパティの名前を recordingDetails.location.altitude に、fileDetails.recordingLocation.location.elevation プロパティの名前を fileDetails.recordingLocation.location.altitude に変更しました。
video リソースの contentDetails.contentRating オブジェクトには、MPAA レーティング、TVPG レーティングなど、さまざまなレーティングスキームで動画に付与されたレーティングを指定します。各レーティングシステムについて、動画にレーティングが設定されていないことを示すレーティング値が API でサポートされるようになりました。MPAA レーティングでは、カット版の映画が公式のレーティングを受けている場合、カットされていないバージョンの映画を識別するために「未レーティング」のレーティングがよく使用されます。
video リソースの新しい contentDetails.contentRating.ytRating プロパティは、年齢制限のあるコンテンツを識別します。YouTube が 18 歳未満のユーザーに不適切なコンテンツが含まれていると判断した場合、プロパティ値は ytAgeRestricted になります。プロパティが存在しない場合、またはプロパティ値が空の場合、コンテンツには年齢制限が設定されていません。
channels.list メソッドの mySubscribers パラメータのサポートが終了しました。subscriptions.list メソッドとその mySubscribers パラメータを使用して、認証済みユーザーのチャンネルのチャンネル登録者のリストを取得します。
channelBanners.insert、channels.update、videos.getRating、videos.rate の各メソッドが onBehalfOfContentOwner パラメータをサポートするようになりました。このパラメータは、認証済みユーザーがパラメータ値で指定されたコンテンツ所有者の代理で行動していることを示します。
channels.update メソッドのドキュメントが更新され、このメソッドを使用して channel リソースの brandingSettings オブジェクトとその子プロパティを更新できることが反映されました。また、channel リソースの invideoPromotion オブジェクトに設定できるプロパティの更新されたリストもドキュメントに記載されています。

error documentation には、次の新しいエラーが記述されています。

エラーのタイプ	エラーの詳細	説明
`forbidden`	`accountDelegationForbidden`	このエラーは特定の API メソッドに固有のものではありません。認証されたユーザーが、指定された Google アカウントの代理として動作する権限を持っていないことを示します。
`forbidden`	`authenticatedUserAccountClosed`	このエラーは特定の API メソッドに固有のものではありません。認証されたユーザーの YouTube アカウントが閉鎖されていることを示します。お客様が別の Google アカウントの代理で操作している場合は、そのアカウントが閉鎖されていることを示します。
`forbidden`	`authenticatedUserAccountSuspended`	このエラーは特定の API メソッドに固有のものではありません。これは、認証されたユーザーの YouTube アカウントが停止されていることを示します。お客様が別の Google アカウントの代理で操作している場合は、そのアカウントが停止されていることを示します。
`forbidden`	`authenticatedUserNotChannel`	このエラーは特定の API メソッドに固有のものではありません。これは、API サーバーが API リクエストに関連付けられたチャネルを識別できないことを示します。リクエストが承認され、`onBehalfOfContentOwner` パラメータを使用している場合は、`onBehalfOfContentOwnerChannel` パラメータも設定する必要があります。
`forbidden`	`cmsUserAccountNotFound`	このエラーは特定の API メソッドに固有のものではありません。その CMS ユーザーは、指定されたコンテンツの所有者に代わって操作を実行することを許可されていません。
`notFound`	`contentOwnerAccountNotFound`	このエラーは特定の API メソッドに固有のものではありません。指定されたコンテンツの所有者アカウントが見つかりませんでした。
`badRequest`	`invalidPart`	このエラーは特定の API メソッドに固有のものではありません。リクエストの `part` パラメータには、同時に書き込めない部分を指定します。
`badRequest`	`videoChartNotFound`	サポートされていない動画グラフまたは利用できない動画グラフがリクエストで指定されている場合、`videos.list` メソッドはこのエラーを返します。
`notFound`	`videoNotFound`	`videos.update` メソッドは、更新しようとしている動画が見つからないことを示すために、このエラーを返します。リクエスト本文の `id` プロパティの値が正しいことを確認します。

2013 年 6 月 10 日

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

channels.list メソッドの新しい forUsername パラメータを使用すると、YouTube ユーザー名を指定してチャンネルに関する情報を取得できます。
activities.list メソッドで regionCode パラメータがサポートされるようになりました。このパラメータは、指定された国に関連する結果を返すよう API に指示します。承認されたユーザーがこれまでに YouTube で行ったアクティビティでは、アクティビティフィードを生成するのに不十分な場合、YouTube はこの値を使用します。
再生リストリソースに snippet.tags プロパティが追加されました。このプロパティは、自分の再生リストに関するデータを取得している承認済みユーザーにのみ返されます。承認済みユーザーは、playlists.insert メソッドまたは playlists.update メソッドを呼び出すときにプレイリストタグを設定することもできます。
channels.list メソッドと search.list メソッドでサポートされていた onBehalfOfContentOwner パラメータが、videos.insert、videos.update、videos.delete メソッドでもサポートされるようになりました。このパラメータを videos.insert メソッドの呼び出しで使用する場合は、リクエストで新しい onBehalfOfContentOwnerChannel パラメータの値も指定する必要があります。このパラメータは、動画を追加するチャンネルを識別します。チャンネルは、onBehalfOfContentOwner パラメータで指定されたコンテンツ所有者にリンクされている必要があります。

このパラメータは、リクエストの認証情報で、パラメータ値で指定されたコンテンツ所有者の代理として行動する YouTube CMS ユーザーが識別されることを示します。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。

このパラメータは、さまざまな YouTube チャンネルを所有して管理しているコンテンツパートナーを対象としています。このパラメータを使用すると、パートナーは一度認証を行うだけで、個々のチャンネルの認証情報を提供することなく、すべての動画とチャンネルのデータにアクセスできます。

今回のリリースでは、このパラメータにより、コンテンツパートナーが所有する任意の YouTube チャンネルに動画を挿入、更新、削除できるようになりました。

error documentation には、次の新しいエラーが記述されています。

エラーのタイプ	エラーの詳細	説明
`forbidden`	`insufficientCapabilities`	このエラーは特定の API メソッドに固有のものではありません。これは、API を呼び出す CMS ユーザーに、リクエストされたオペレーションを実行するための十分な権限がないことを示します。このエラーは、複数の API メソッドでサポートされている `onBehalfOfContentOwner` パラメータの使用に関連しています。
`unauthorized`	`authorizationRequired`	リクエストで `home` パラメータが使用されているにもかかわらず、適切に承認されていない場合、`activities.list` メソッドはこのエラーを返します。

channels リソースでは、チャンネル ID がリソースの id プロパティですでに指定されているため、invideoPromotion.channelId プロパティが削除されました。
新しいチャンネル ID の使用ガイドでは、API がチャンネル ID を使用する方法について説明しています。このガイドは、以前のバージョンの API から移行し、default ユーザーのコンテンツをリクエストするアプリケーション、またはすべての YouTube チャンネルに固有のユーザー名があるという概念に依存するアプリケーションを開発しているデベロッパーにとって特に役立ちます。

2013 年 5 月 22 日

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

新しい channelBanners.insert メソッドを使用すると、バナー画像をアップロードして、channel リソースの新しい brandingSettings.image.bannerExternalUrl プロパティを使用してチャンネルのバナー画像として設定できます。
channels.update メソッドのドキュメントを更新し、メソッドの呼び出し時に変更できるプロパティをリストに追加しました。
video リソースのドキュメントから、suggestions.processingErrors[]、suggestions.processingHints[]、suggestions.processingWarnings[]、suggestions.editorSuggestions[] プロパティの有効なプロパティ値として unspecified が削除されました。
videos.list メソッドの maxResults パラメータのデフォルト値が 5 になりました。
error documentation に、channelBanners.insert メソッドと subscriptions.list メソッドのエラーが表示されるようになりました。また、channels.update メソッドの新しいエラーもいくつかリストされています。

2013 年 5 月 14 日

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

スタンドアロンページに、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 に設定すると、動画の明るさと色を自動的に補正するよう YouTube に指示します。
- stabilize - このパラメータ値を true に設定すると、カメラの動きによる手ブレを除去して動画を調整するよう YouTube に指示します。
次のリソースの 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`
オーストラリア	オーストラリア等級審査委員会（ACB）	`contentDetails.contentRating.acbRating`
ブラジル	Departamento de Justiça, Classificação, Qualificação e Títulos	`contentDetails.contentRating.djctqRating`
カナダ	カナダ家庭用ビデオレーティングシステム（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`
インド	中央映画認証委員会（CBFC）	`contentDetails.contentRating.cbfcRating`
日本	映倫管理委員会（EIRIN）	`contentDetails.contentRating.eirinRating`
韓国	영상물등급위원회（KMRB）	`contentDetails.contentRating.kmrbRating`
メキシコ	General Directorate of Radio, Television and Cinematography（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`	リクエストメタデータが無効です。

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

2013 年 3 月 12 日

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

次のリソースの snippet に channelTitle プロパティが追加されました。
- activity - このプロパティには、アクティビティを担当するチャネルの名前を指定します。
- search - このプロパティには、検索結果で識別されるリソースに関連付けられているチャンネルの名前を指定します。
- video - このプロパティには、動画をアップロードしたチャンネルの名前を指定します。
search.list メソッドは、次の新しいパラメータをサポートしています。
- channelType パラメータを使用すると、チャンネルの検索を制限して、すべてのチャンネルを取得することも、番組のみを取得することもできます。
- videoType パラメータを使用すると、動画の検索を制限して、すべての動画を取得するか、映画のみまたは番組のエピソードのみ取得できます。
video リソースの recordingDetails 部分の定義が更新され、動画の位置情報データまたは録画時間が設定されている場合にのみ、動画に対してオブジェクトが返されることが明記されました。
playlistItems.update メソッドが invalidSnippet エラーを返すようになりました。このエラーは、API リクエストで有効なスニペットが指定されていない場合に返されます。
いくつかの API メソッドは、YouTube コンテンツパートナー専用の新しいパラメータをサポートしています。YouTube コンテンツパートナーには、映画やテレビのスタジオ、レコードレーベル、YouTube でコンテンツを公開しているその他のコンテンツクリエイターが含まれます。
- onBehalfOfContentOwner パラメータは、リクエストの認可認証情報で、パラメータ値で指定されたコンテンツ所有者の代理として行動する YouTube CMS ユーザーが識別されることを示します。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。
  
  このパラメータは、さまざまな YouTube チャンネルを所有して管理しているコンテンツパートナーを対象としています。このパラメータを使用すると、パートナーは一度認証を行うだけで、個々のチャンネルの認証情報を提供することなく、すべての動画とチャンネルのデータにアクセスできます。
  
  channels.list、search.list、videos.delete、videos.list、videos.update の各メソッドはすべてこのパラメータをサポートしています。
- channels.list メソッドでサポートされている managedByMe パラメータは、onBehalfOfContentOwner パラメータで指定されたコンテンツ所有者が所有するすべてのチャンネルを返すように API に指示します。
- search.list メソッドでサポートされている forContentOwner パラメータは、onBehalfOfContentOwner パラメータで指定されたコンテンツ所有者が所有するリソースのみを検索結果に含めるように API に指示します。

2013 年 2 月 25 日

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

この API は、video リソースの新しい部分とプロパティをいくつかサポートしています。
- 新しい fileDetails、processingDetails、suggestions の各部分には、アップロードされた動画に関する情報が動画所有者に提供されます。このデータは、動画のアップロードを可能にするアプリで非常に役立ちます。次のようなデータが含まれます。
  - 処理ステータスと進行状況
  - 動画の処理中に発生したエラーやその他の問題
  - サムネイル画像の可用性
  - 動画やメタデータの品質を改善するための提案
  - YouTube にアップロードされた元のファイルの詳細
  これらの部分を取得できるのは、動画の所有者に限られます。以下のリストに、新しいパートの概要を示します。video リソースのドキュメントでは、各パートに含まれるすべてのプロパティを定義しています。
  - fileDetails オブジェクトには、YouTube にアップロードされた動画ファイルに関する情報（ファイルの解像度、再生時間、音声コーデック、動画コーデック、ストリームビットレートなど）が含まれます。
  - processingProgress オブジェクトには、アップロードされた動画ファイルの処理の進捗状況に関する情報が含まれます。オブジェクトのプロパティには、現在の処理ステータスと、YouTube が動画の処理を完了するまでの残り時間が示されます。また、この部分は、ファイルの詳細やサムネイル画像など、さまざまなタイプのデータやコンテンツを動画で利用できるかどうかも示しています。
    このオブジェクトは、動画アップロード者がアップロードした動画ファイルの処理状況をトラッキングできるように、ポーリングするように設計されています。
  - suggestions オブジェクトには、アップロードされた動画の動画品質やメタデータを改善できる機会を特定する候補が含まれます。
- contentDetails 部分には、4 つの新しいプロパティが含まれています。これらのプロパティは、未認証のリクエストで取得できます。
  - dimension - 動画が 2D または 3D で視聴可能かどうかを示します。
  - definition - 動画を標準解像度または高解像度で提供できるかどうかを示します。
  - caption - 動画で字幕を使用できるかどうかを示します。
  - licensedContent - YouTube コンテンツパートナーから申し立てを受けたコンテンツが動画に含まれているかどうかを示します。
- status 部分には 2 つの新しいプロパティが含まれています。動画の所有者は、動画を挿入または更新するときに、両方のプロパティの値を設定できます。これらのプロパティは、未認証のリクエストで取得することもできます。
  - embeddable - 動画を他のウェブサイトに埋め込めるかどうかを示します。
  - license - 動画のライセンスを指定します。有効な値は creativeCommon と youtube です。
part パラメータの定義が videos.list、videos.insert、videos.update メソッドで更新され、上記で説明した新しく追加された部分と、誤って省略されていた recordingDetails 部分が一覧表示されるようになります。
channel リソースの新しい contentDetails.googlePlusUserId プロパティには、チャンネルに関連付けられた Google+ プロフィール ID を指定します。この値は、Google+ プロフィールへのリンクを生成するために使用できます。
各サムネイル画像オブジェクトで画像の幅と高さを指定できるようになりました。現在、サムネイル画像は activity、channel、playlist、playlistItem、search result、subscription、video リソースで返されます。
playlistItems.list で videoId パラメータがサポートされるようになりました。このパラメータは playlistId パラメータと組み合わせて使用し、指定した動画を表す再生リストアイテムのみを取得できます。

パラメータで指定された動画が再生リストに見つからない場合、API は notFound エラーを返します。
エラーのドキュメントでは、リクエストされたアクションに対してリクエストが適切に承認されていないことを示す新しい forbidden エラーについて説明しています。
channel リソースの snippet.channelId プロパティが削除されました。リソースの id プロパティには同じ値が提供されます。

2013 年 1 月 30 日

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

新しい [エラー] ページには、API が返す可能性があるエラーが一覧表示されます。このページには、複数の異なる API メソッドで発生する可能性のある一般的なエラーと、メソッド固有のエラーが含まれています。

2013 年 1 月 16 日

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

以下のリストに示すメソッドと言語のコードサンプルをご利用いただけるようになりました。
- activities.insert - 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 パラメータは、publishedAfter と publishedBefore の 2 つの新しいパラメータに置き換えられました。以下に説明します。

search.list メソッドは、次の新しいパラメータをサポートしています。

パラメータ名	値	説明
`channelId`	`string`	指定したチャネルによって作成されたリソースを返します。
`publishedAfter`	`datetime`	指定した時間以降に作成されたリソースを返します。
`publishedBefore`	`datetime`	指定した時刻より前に作成されたリソースを返します。
`regionCode`	`string`	指定された国のリソースを返します。
`videoCategoryId`	`string`	動画検索結果をフィルタして、指定した動画カテゴリに関連付けられている動画のみを表示します。
`videoEmbeddable`	`string`	動画検索結果をフィルタして、ウェブページに埋め込まれたプレーヤーで再生できる動画のみを表示します。パラメータ値を `true` に設定すると、埋め込み可能な動画のみが取得されます。
`videoSyndicated`	`string`	動画検索結果をフィルタして、YouTube.com の外部で再生できる動画のみを表示します。パラメータ値を `true` に設定すると、配信動画のみを取得できます。

いくつかの API リソースは、新しいプロパティをサポートしています。次の表に、リソースとその新しいプロパティを示します。

リソース	プロパティ名	値	説明
`activity`	`contentDetails.playlistItem.playlistItemId`	`string`	再生リスト内のアイテムを一意に識別するために YouTube が割り当てた再生リストアイテム ID。
`activity`	`contentDetails.channelItem`	`object`	チャンネルに追加されたリソースに関する情報を含むオブジェクト。このプロパティは、`snippet.type` が `channelItem` の場合にのみ存在します。
`activity`	`contentDetails.channelItem.resourceId`	`object`	チャンネルに追加されたリソースを識別するオブジェクト。他の `resourceId` プロパティと同様に、動画や再生リストなどのリソースタイプを指定する `kind` プロパティが含まれています。また、そのリソースを一意に識別する ID を指定する `videoId`、`playlistId` などの複数のプロパティのいずれか 1 つが含まれています。
`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 メソッドを使用して、有効な値のリストを取得します。

変更履歴 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

2025 年 3 月 26 日

2024 年 10 月 30 日

2024 年 4 月 30 日

2024 年 3 月 13 日

2024 年 3 月 12 日

2024 年 3 月 7 日

2024 年 1 月 31 日

2023 年 11 月 9 日

2023 年 9 月 12 日

2023 年 8 月 22 日

2023 年 8 月 18 日

2023 年 8 月 7 日

2023 年 6 月 28 日

2023 年 6 月 12 日

2022 年 8 月 22 日

2022 年 8 月 5 日

2022 年 7 月 12 日

2022 年 4 月 27 日

2022 年 4 月 8 日

2021 年 12 月 15 日

2021 年 11 月 18 日

2021 年 7 月 2 日

2021 年 7 月 1 日

2021 年 5 月 12 日

2021 年 2 月 9 日

2021 年 1 月 28 日

2020 年 10 月 15 日

2020 年 10 月 8 日

2020 年 9 月 9 日

2020 年 7 月 29 日

2020 年 7 月 28 日

2020 年 7 月 21 日

2020 年 7 月 7 日

2020 年 6 月 15 日

2020 年 6 月 4 日

2020 年 4 月 17 日

2020 年 3 月 31 日

2020 年 1 月 10 日

2019 年 9 月 10 日

2019 年 4 月 4 日

2018 年 7 月 9 日

2018 年 6 月 22 日

2017 年 11 月 27 日

2017 年 11 月 16 日

2017 年 10 月 25 日

2017 年 8 月 29 日

2017 年 7 月 24 日

2017 年 6 月 1 日

2017 年 5 月 17 日

2017 年 4 月 27 日

2017 年 3 月 30 日

2017 年 2 月 27 日

2016 年 11 月 29 日

2016 年 11 月 10 日

2016 年 11 月 2 日

2016 年 9 月 15 日

2016 年 8 月 11 日

2016 年 6 月 13 日

2016 年 5 月 31 日

2016 年 5 月 17 日

2016 年 4 月 28 日

2016 年 4 月 20 日

2016 年 3 月 16 日

2015 年 12 月 18 日

2015 年 11 月 19 日

2015 年 11 月 4 日

2015 年 8 月 28 日

2015 年 8 月 7 日

2015 年 6 月 18 日

2015 年 4 月 27 日

2015 年 4 月 16 日

2015 年 4 月 9 日

2015 年 4 月 2 日

2015 年 3 月 11 日

2015 年 3 月 4 日

2015 年 3 月 2 日

2015 年 1 月 14 日

2014 年 11 月 11 日

2014 年 10 月 8 日

変更履歴
コレクションでコンテンツを整理必要に応じて、コンテンツの保存と分類を行います。