Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

変更履歴

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

2026 年 9 月 30 日

comments リソース定義が更新され、新しい snippet.imageUrl プロパティが含まれるようになりました。このプロパティは、コメントに添付された画像または GIF アニメーションの URL を提供します。

この機能は、2026 年 11 月にすべてのユーザーが利用できるようになります。

2026 年 9 月 14 日

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

thumbnails.set メソッドの説明が更新され、アップロードされたサムネイルの最大ファイルサイズが 2 MB から 50 MB に引き上げられたことが記載されました。
playlistImages.insert メソッドの説明が更新され、アップロードされる画像の最大ファイルサイズが 2 MB から 50 MB に引き上げられたことが記載されました。

2026 年 9 月 11 日

activities、liveBroadcasts、playlistItems、playlists、search、videos リソースの参照ドキュメントで snippet.thumbnails.(key) プロパティの定義が更新され、一部の動画で高解像度のサムネイルサイズ（fhd（1080p）、qhd（1440p）、uhd（4K））が利用可能になったことが記載されています。

2026 年 9 月 1 日

videos.getRating メソッドが https://www.googleapis.com/auth/youtube.readonly 認可スコープを受け入れるようになりました。

2026 年 8 月 27 日

YouTube は、すべての動画フォーマット（長尺動画、ライブ配信、ショート動画）の公開視聴回数のカウント方法を統一します。YouTube では、動画の再生が開始された時点で公開視聴回数がカウントされます。

収益化の対象となる条件と、主要なパフォーマンス指標の大部分は、エンゲージメント指標に引き続き基づいているため、影響を受けません。クリエイターの収益は、引き続き「ショート動画のエンゲージビュー」と「エンゲージ総再生時間」に基づいて計算されます。これらの指標は、YouTube アナリティクス > [詳細モード] で確認できます。

YouTube パートナープログラムの資格要件に変更はありません。YouTube パートナープログラムの参加基準は、以前は「有効な公開ショート動画の視聴回数」と「有効な公開動画の総再生時間」でしたが、今後は「対象となるショート動画の視聴回数」と「対象となる動画の総再生時間」となります。

詳しくは、YouTube コンテンツのパフォーマンスを把握するをご覧ください。

指標	ステータス	トリガー	Used For
表示	更新	動画が最初のフレームから再生される（自動再生、ポインタを合わせる、クリック/タップして再生など）。	標準の公開視聴回数。
エンゲージビュー	変更なし	最初のフレームを超えて再生が続行されるか、ユーザーがクリックまたはタップして再生する。	YouTube パートナープログラムによる収益化、主要な分析情報の大部分（クリック率、平均視聴時間）、エンゲージメントレポート。
サムネイルのインプレッション数	変更なし	サムネイルが操作や自動再生なしで表示される。	フィードレベルの露出とパッケージングを測定します。

API ドキュメントの更新: channels と videos のリファレンスドキュメントで、viewCount フィールドの説明を更新しました。

2026 年 8 月 6 日

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

activities.contentDetails の contentDetails.like フィールドと contentDetails.favorite フィールドへの参照は、これらのフィールドが API から返されないため、公開ドキュメントから削除されました。

2026 年 7 月 7 日

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

API は、videos リソースの brandPartner 部分をサポートするようになりました。この部分には、クリエイター主導のブランドパートナーアクセスで動画にリンクされているブランドパートナーの詳細が表示されます。

brandPartner 部分は、次のメソッドを呼び出すときに指定できます。

brandPartner オブジェクトには次のフィールドがあります。

channelId: ブランドパートナーの外部チャネル ID。
channelHandle: ブランドパートナーのチャンネルハンドル。

リンクを確立するときは channelId または channelHandle のいずれかを設定する必要がありますが、レスポンスで返されるのは channelId のみです。

2026 年 6 月 23 日

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

liveChatMessages の messageDeletedEvent リソースタイプと messageRetractedEvent リソースタイプ（および対応する messageDeletedDetails オブジェクトと messageRetractedDetails オブジェクト）への参照は、これらのイベントが API から返されないため削除されました。

2026 年 6 月 3 日

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

API で新しいメソッド videos.batchGetStats がサポートされるようになりました。このメソッドは、API リクエストパラメータに一致する動画統計情報のリストを取得します。

このメソッドの呼び出しには、独自の粒度の細かい割り当てバケットで 1 ユニットの割り当て費用が発生します。このメソッドのデフォルトの割り当ては、1 日あたり 10,000 ユニットです。

2026 年 6 月 1 日

YouTube Data API は、videos.insert と search.list を皮切りに、より小規模なメソッドのセットを対象とするきめ細かい割り当てシステムに移行しています。

この更新により、YouTube は特定の方法の使用状況に基づいてリクエストをより簡単に確認して承認できるようになり、割り当て増加への道筋が簡素化されます。この移行は、プラットフォームの安定性とセキュリティに対する Google の取り組みの重要な一環でもあります。すべてのデベロッパーが、承認されたユースケースに必要なアクセスレベルを維持しながら、保護されたエコシステム内で運用できるようにします。

videos.insert メソッドと search.list メソッドへの API 呼び出しは、それぞれ独自の割り当てバケットに課金されます。他のすべてのメソッドに対する API 呼び出しは、既存の割り当てバケットに課金されます。デベロッパーは Google Cloud コンソールで割り当て上限を確認できます。また、割り当て拡張フォームから追加の割り当てをリクエストすることもできます。

2025 年 12 月 4 日

YouTube Data API のドキュメントと割り当て計算ツールが更新され、動画のアップロードの割り当てコストが約 1,600 ユニットから約 100 ユニットに変更されたことが反映されています。

2025 年 7 月 10 日

2025 年 7 月 21 日より、YouTube は video.list メソッドの mostPopular チャートで返されるコンテンツを調整します。以前は、mostPopular チャートには [急上昇] リストに掲載された動画が反映されていました。mostPopular チャートには、急上昇中の音楽、映画、ゲームのチャートの動画が表示されるようになります。この API の変更は、YouTube の急上昇ページのサポート終了と同時に行われます。

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 ウェブサイトでサポートされている機能と一致しています。YouTube ウェブサイトでは、チャンネルへのコメントの投稿はサポートされていません。

2024 年 3 月 13 日

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

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

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

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

2024 年 3 月 12 日

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

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

2024 年 3 月 7 日

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

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

2024 年 1 月 31 日

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

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

2023 年 11 月 9 日

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 フィールドの型アノテーションを符号なし長整数から文字列に修正しました。

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

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

低評価数を一般公開せず、API クライアントで低評価数を必要とするデベロッパーは、例外の許可リストに登録するための申請を行うことができます。免除を申請するには、こちらの申請フォームにご記入いただく必要があります。

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

2021 年 7 月 2 日

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

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

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

2021 年 7 月 1 日

YouTube の API サービスを使用するすべてのデベロッパーは、デフォルトの割り当てである 10,000 ユニットを超える割り当てを受けるために、API 準拠監査を完了する必要があります。これまで、コンプライアンス監査プロセスと追加の割り当てユニットの割り当てリクエストは、デベロッパーが YouTube API サービス - 監査と割り当ての延長に関するフォームに記入して送信することで実施されてきました。

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

監査および割り当ての延長の申請フォーム: API コンプライアンス監査にすでに合格しているデベロッパーは、このフォームに記入して送信し（最初の質問で [現在の割り当てを維持するためのコンプライアンス監査（再監査の完了を求められた）] を選択）、割り当てられた割り当ての延長をリクエストできます。
再審査請求フォーム: API プロジェクトがコンプライアンス監査に不合格となった（または割り当て単位の増加が拒否された）デベロッパーは、このフォームに記入して送信できます。
支配権の変更フォーム: API プロジェクトに関連して支配権の変更（株式の売買、合併、その他の企業取引など）が発生したデベロッパー、またはデベロッパーに代わって API クライアントを運営する当事者は、このフォームに記入して送信する必要があります。これにより、YouTube の API チームは、記録の更新、新しい API プロジェクトのユースケースのコンプライアンスの監査、デベロッパーの現在の割り当ての検証を行うことができます。

新しいフォームにご記入いただくことで、YouTube の API の使用目的を把握し、より適切なサポートを提供できるようになります。

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

2021 年 5 月 12 日

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

このアップデートでは、次の API の変更が適用されています。

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

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

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

2021 年 2 月 9 日

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

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

2021 年 1 月 28 日

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

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

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

2020 年 10 月 15 日

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

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

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

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

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 パラメータを使用して、認証済みユーザーのチャンネルの登録者リストを取得します。
2017 年 11 月 27 日に非推奨として発表された channel リソースの invideoPromotion オブジェクトとそのすべての子プロパティが、ドキュメントから削除されました。

2020 年 7 月 29 日

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

この変更により、ほとんどの 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 デベロッパーポリシーの遵守ガイドでは、YouTube API サービスの利用規約とポリシー（API TOS）の特定の部分を API クライアントが遵守できるように、ガイダンスと例を提供しています。

このガイダンスは、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 レスポンスを確認できます。このウィジェットには、入力したスコープと値を使用して動的に更新される完全なコードサンプルを表示する全画面表示もあります。
- 一般的なユースケース セクションでは、このページで説明するメソッドの一般的なユースケースを 1 つ以上説明します。たとえば、channels.list メソッドを呼び出して、特定のチャンネルに関するデータを取得したり、現在のユーザーのチャンネルに関するデータを取得したりできます。
  
  このセクションのリンクを使用すると、ユースケースのサンプル値で API Explorer を入力したり、これらの値がすでに入力された状態で API Explorer を全画面表示で開いたりできます。これらの変更は、ご自身のアプリケーションで実装しようとしているユースケースに直接適用できるコードサンプルを簡単に見つけられるようにすることを目的としています。
現在、Java、JavaScript、PHP、Python、curl のコードサンプルがサポートされています。
コードサンプルツールも、上記のすべての機能を提供する新しい UI で更新されました。このツールを使用すると、さまざまなメソッドのユースケースを調べたり、API Explorer に値を読み込んだり、API Explorer を全画面表示して Java、JavaScript、PHP、Python のコードサンプルを取得したりできます。

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

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

2018 年 7 月 9 日

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

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

2018 年 7 月より、チャンネルのサムネイル URL は https ドメインでのみ利用可能になります。これは、API レスポンスで URL が表示される方法です。この期間を過ぎると、アプリが http ドメインから YouTube の画像を読み込もうとした場合に、画像が破損して表示されることがあります。
注: これはサポート終了のお知らせです。

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

2018 年 6 月 22 日

実装ガイド（以前は実装と移行ガイドと呼ばれていました）が更新され、v2 API から v3 API への移行手順が削除されました。また、お気に入りの動画など、v3 API で非推奨になった機能の手順も削除されました。

2017 年 11 月 27 日

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

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

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

2017 年 12 月 14 日までは、invideoPromotion データの取得と設定が可能です。その日以降は、次のようになります。
- channels.list を呼び出すときに invideoPromotion 部分を取得しようとすると、空の invideoPromotion が返されるか、invideoPromotion データがまったく返されません。
- channels.update を呼び出すときに invideoPromotion データの更新を試みると、少なくとも 2018 年 5 月 27 日までは成功レスポンスが返されますが、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. インタラクティブなコードスニペットツールに移動するか、channels.list メソッドなどの API メソッドのドキュメントに移動します。
2. コードサンプルの上にある Python タブをクリックします。
3. タブの上にある切り替えボタンをクリックすると、スニペットから完全なサンプルに切り替わります。
4. タブに、InstalledAppFlow 認証フローを使用する完全なコードサンプルが表示されます。上記のサンプルの説明で、この点について説明し、ウェブサーバーアプリケーションのサンプルへのリンクも示しています。
5. リンクをクリックして、ウェブサーバーの例に切り替えます。このサンプルでは、Flask ウェブアプリケーションフレームワークと別の認可フローを使用しています。
これらのサンプルはすべて、ダウンロードしてローカルで実行するように設計されています。サンプルを実行する場合は、コードスニペットツールの手順にある完全なコードサンプルをローカルで実行するの手順をご覧ください。

2017 年 8 月 29 日

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

search.list メソッドの forContentOwner パラメータの定義が更新され、このパラメータが true に設定されている場合は、type パラメータを video に設定する必要があることが明記されました。
search.list メソッドの regionCode パラメータの定義が更新され、このパラメータによって検索結果が指定された地域で視聴できる動画に制限されることが明確になりました。
YouTube のブランディングロゴとアイコンが更新されました。新しい「developed with YouTube」ロゴは、ブランドガイドラインのページからダウンロードできます。その他の新しい YouTube のロゴとアイコンもこのページに表示されており、YouTube ブランドサイトからダウンロードできます。

2017 年 7 月 24 日

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

iOS 向けの新しい YouTube Data API クイックスタートガイドが公開されました。このガイドでは、Objective-C または Swift で記述されたシンプルな iOS アプリケーションで YouTube Data API を使用する方法について説明します。
YouTube Data API のインタラクティブコードスニペットツールに、ツールの機能の一部を説明するドキュメントが追加されました。
- API リクエストの実行
- コードスニペットと完全なコードサンプルの切り替え
- ボイラープレート関数を使用する
- 既存のリソースを読み込む（更新メソッドの場合）
注: このツールは、API メソッドの API リファレンスドキュメントにも埋め込まれています（例）。

2017 年 6 月 1 日

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

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

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

2017 年 5 月 17 日

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

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

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

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

2017 年 4 月 27 日

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

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

2017 年 3 月 30 日

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

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

2017 年 2 月 27 日

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

キュレーションリストにはいくつかの変更があります。

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

名前トピック ID

ビジネス /m/09s1f

健康 /m/0kt51

軍事 /m/01h6rj

政治 /m/05qt0

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

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

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

2016 年 11 月 29 日

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

2017 年 2 月 10 日よりサポートされるトピック ID のリストに、次の 3 つの小さな変更が加えられます。
- 以前は Sports カテゴリの子であった Professional wrestling カテゴリが、Entertainment の子になりました。
- Entertainment の子である TV shows カテゴリは新しいものです。
- 以前は Lifestyle の子であった Health カテゴリが削除されました。
また、親カテゴリ（Entertainment、Gaming、Lifestyle、Music、Sports）がいくつかあります。Tennis などの子カテゴリに関連付けられている動画は、親カテゴリ（Sports）にも関連付けられます。

2016 年 11 月 10 日

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

2016 年 8 月 11 日に初めて発表したとおり、Freebase と Freebase API の非推奨化に伴い、トピック ID に関連するいくつかの変更が必要になります。トピック ID は channel リソースと video リソースに関連付けられたトピックを識別します。また、topicId 検索パラメータを使用して、特定のトピックに関連するチャンネルや動画を見つけることもできます。

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

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

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

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`homeParameterDeprecated`	`activities.list` メソッドは、この API を介してユーザーのホームページアクティビティデータを利用できないことを示すために、このエラーを返します。このエラーは、未承認のリクエストで `home` パラメータを `true` に設定した場合に発生することがあります。
`invalidValue (400)`	`invalidContentDetails`	`playlistItems.insert` メソッドは、リクエスト内の `contentDetails` オブジェクトが無効であることを示すために、このエラーを返します。このエラーが発生する理由の一つは、`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 に関連するいくつかの変更について説明しました。その中で、サポートされるトピック ID のセットが 2017 年 2 月 10 日から変更されることもお知らせしました。サポートされるトピックのリストは、2016 年 11 月 10 日までに公開されます。
以下の変更が有効になりました。これらの変更については、2016 年 8 月 11 日の変更履歴の更新でお知らせしました。
- home パラメータが true に設定された状態で activities.list メソッドが呼び出されると、API レスポンスには、ログアウトした YouTube ユーザーがホームページで見るものと同様のアイテムが含まれるようになります。
  
  これは、2016 年 8 月 11 日の変更履歴の更新で説明した動作よりもユーザーエクスペリエンスを向上させるためのわずかな変更です。この更新では、home パラメータを使用するリクエストは空のリストを返すことが記載されていました。
- channel リソースの contentDetails.relatedPlaylists.watchHistory プロパティと contentDetails.relatedPlaylists.watchLater プロパティに、すべてのチャネルの HL と WL の値がそれぞれ含まれるようになりました。
  
  これらのプロパティは、ユーザー自身のチャンネルに関するデータを取得する承認済みユーザーにのみ表示されます。プロパティには、ユーザー自身のチャンネルに関するデータを取得する承認済みユーザーの場合でも、常に HL と WL の値が含まれます。そのため、API を使用して再生履歴と [後で見る] 再生リストの ID を取得することはできません。
  
  また、チャンネルの再生履歴または [後で見る] 再生リストの再生リストの詳細（playlists.list）または再生リストアイテム（playlistItems.list）を取得するリクエストは、空のリストを返すようになりました。この動作は、新しい値 HL と WL のほか、API クライアントがすでに保存している可能性のある再生履歴または後で見るプレイリストの ID にも当てはまります。
video リソースの fileDetails.recordingLocation オブジェクトとその子プロパティが返されなくなりました。以前は、このデータ（親 fileDetails オブジェクトなど）は動画の所有者のみが取得できました。

2016 年 8 月 11 日

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

YouTube エンジニアリングとデベロッパーのブログで詳しく説明されている、新しく公開された YouTube API サービスの利用規約（以下「更新された規約」）では、現在の利用規約に対してさまざまな更新が行われています。2017 年 2 月 10 日より発効する更新された利用規約に加え、この更新には、デベロッパーが遵守すべきポリシーを説明する複数の補足ドキュメントが含まれています。

新しいドキュメントの完全なセットについては、更新された利用規約の変更履歴をご覧ください。また、更新された規約またはその関連文書の今後の変更についても、その変更履歴で説明します。ドキュメント内のリンクから、その改訂履歴の変更を一覧表示する RSS フィードを購読できます。
Freebase と Freebase API のサポート終了に伴い、トピック ID に関連する変更がいくつか行われています。トピック ID は、次の API リソースとメソッドで使用されます。
- channel リソースの topicDetails 部分は、チャンネルに関連付けられたトピックを識別します。
- video リソースの topicDetails 部分は、動画に関連付けられたトピックを識別します。
- search.list メソッドの topicId パラメータを使用すると、特定のトピックに関連する動画やチャンネルを検索できます。
これらの機能の変更点は次のとおりです。
- 2017 年 2 月 10 日より、YouTube は、これまで返していた非常に詳細な 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 の値を返します。
  
  チャンネルの再生履歴または [後で見る] 再生リストの再生リストの詳細（playlists.list）を取得するリクエストは、2016 年 9 月 12 日以降は空のリストを返します。これらの再生リストのいずれかで再生リストアイテム（playlistItems.list）を取得するリクエストも、その時間以降は空のリストを返します。これは、新しい値 HL と WL のほか、API クライアントがすでに保存している可能性のある再生履歴または後で見るプレイリストの ID にも当てはまります。
- 2016 年 9 月 12 日以降、video リソースの fileDetails.recordingLocation オブジェクトまたはその子プロパティは返されなくなります。親 fileDetails オブジェクトは動画の所有者のみが取得できるため、このデータは動画の所有者のみが取得できます。

2016 年 6 月 13 日

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

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

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

2016 年 5 月 31 日

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

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

新しいパラメータは、認証済みユーザーのチャンネルの最新のチャンネル登録者 1,000 人の取得のみをサポートします。サブスクライバーの完全なリストを取得するには、mySubscribers パラメータを使用します。このパラメータは、特定の順序でサブスクライバーを返さず、取得できるサブスクライバーの数を制限しません。
アクティビティ、playlistItem、再生リスト、検索結果、サムネイル、動画リソースの snippet.thumbnails.(key) プロパティの定義が更新され、一部の動画で追加のサムネイル画像サイズが利用可能であることが明記されました。
- standard 画像の幅は 640 ピクセル、高さは 480 ピクセルです。
- maxres 画像の幅は 1,280 ピクセル、高さは 720 ピクセルです。
channelSection.list メソッドの part パラメータの定義が更新され、targeting 部分は 2 割り当て単位の費用で取得できることが記載されました。
videos.list メソッドは、不正に認可されたリクエストが video リソースの fileDetails、processingDetails、suggestions 部分を取得しようとしたときに、forbidden（403）エラーを返すようになりました。これらの部分は動画の所有者のみが利用できます。

2016 年 5 月 17 日

新しい Data API コードスニペットツールでは、一般的な YouTube Data API のユースケースに対応した短いコードスニペットが提供されます。コードスニペットは現在、Apps Script、Go、JavaScript、PHP、Python、Ruby のすべての読み取り専用 API メソッドで使用できます。

各メソッドについて、1 つ以上のユースケースのコードサンプルが表示されます。たとえば、search.list メソッドの 5 つのコードスニペットが提供されます。

キーワードで動画を一覧表示する
場所別に動画を一覧表示する
ライブイベントのリストを取得する
認証済みユーザーの動画を検索する
関連動画を一覧表示する

このツールは、各ユースケースについて、API リクエストで使用されるパラメータを表示します。パラメータ値を変更できます。その場合、ツールは、指定したパラメータ値を反映するようにコードスニペットを更新します。

最後に、ツールは各リクエストに対する API レスポンスを表示します。リクエストパラメータを変更した場合、API レスポンスは指定したパラメータ値に基づきます。API レスポンスを表示するには、ツールがユーザーに代わってリクエストを送信することを承認する必要があります。

2016 年 4 月 28 日

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

video リソースの新しい contentDetails.projection プロパティは、動画の投影形式を指定します。有効なプロパティ値は 360 と rectangular です。
video リソースの recordingDetails.location プロパティと fileDetails.recordingLocation プロパティの両方が更新され、2 つのプロパティの違いが説明されています。
- recordingDetails.location プロパティは、動画の所有者が動画に関連付ける場所を特定します。この場所は編集可能で、公開動画の場合は検索される可能性があります。また、公開動画の場合はユーザーに表示される可能性があります。
- fileDetails.recordingLocation プロパティ値は不変で、アップロードされた元の動画ファイルに関連付けられた場所を表します。この値は動画の所有者にのみ表示されます。
channel リソースの contentDetails.relatedPlaylists.favorites プロパティの定義が更新され、プロパティ値に空の再生リストを参照する再生リスト ID が含まれる可能性があり、その ID を取得できないことが記載されました。これは、お気に入りの動画機能がすでに非推奨になっているためです。このプロパティは API の非推奨ポリシーの対象外です。
comments.insert、comments.update、commentThreads.insert、または commentThreads.update メソッドから返される ineligibleAccount エラーの定義が更新され、API リクエストの承認に使用された YouTube アカウントがユーザーの Google アカウントと統合されていない場合にエラーが発生することが反映されました。

2016 年 4 月 20 日

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

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

2016 年 3 月 16 日

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

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

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

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

2015 年 12 月 18 日

欧州連合（EU）の法律では、EU のエンドユーザーに対して特定の情報を開示し、同意を得ることを義務付けています。そのため、欧州連合に居住するエンドユーザーに対しては、EU ユーザーの同意ポリシーを遵守する必要があります。この要件に関する通知を YouTube API 利用規約に追加しました。

2015 年 11 月 19 日

この API は、playlist リソースと video リソースの snippet.title プロパティと snippet.description プロパティ、channelSection リソースの snippet.title プロパティ、channel リソースの snippet.description プロパティのローカライズされたテキストを設定して取得する機能をサポートするようになりました。

ローカライズされたタイトルと説明を設定する

リソースの insert メソッドまたは update メソッドを呼び出すときに、リソースのローカライズされた値を設定できます。リソースのローカライズされた値を設定するには、次の両方を行います。
- リソースの snippet.defaultLanguage プロパティに値が設定されていることを確認します。このプロパティは、リソースの snippet.title プロパティと snippet.description プロパティの言語を識別します。値には、サポートされているアプリケーション言語またはその他のほとんどの ISO 639-1:2002 言語コードを指定できます。たとえば、英語のタイトルと説明を含む動画をアップロードする場合は、snippet.defaultLanguage プロパティを en に設定します。
  
  channel リソースの更新に関する注: channel リソースの snippet.defaultLanguage プロパティを設定するには、実際に brandingSettings.channel.defaultLanguage プロパティを更新する必要があります。
- 更新するリソースに localizations オブジェクトを追加します。各オブジェクトキーは、アプリケーション言語または ISO 639-1:2002 言語コードを識別する文字列です。各キーは、リソースのローカライズされたタイトル（と説明）を含むオブジェクトにマッピングされます。
  
  次のサンプルスニペットでは、リソースのデフォルト言語を英語に設定しています。また、ローカライズされたドイツ語とスペイン語のタイトルと説明を動画に追加します。
```
{
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    ...
  },
  "localizations":
    "de": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    },
    "es": {
      "title": "Jugar al fútbol",
      "description": "Nosotros jugamos fútbol en el parque los domingos",
    }
  }
}
```
ローカライズされた値を取得する

この API では、リソースのローカライズされた値を取得する 2 つの方法がサポートされています。
- channels.list、channelSections.list、playlists.list、または videos.list リクエストに hl パラメータを追加して、YouTube ウェブサイトがサポートする特定のアプリケーション言語のローカライズされたデータを取得します。その言語でローカライズされたリソースの詳細が利用可能な場合、リソースの snippet.localized オブジェクトにはローカライズされた値が含まれます。ただし、ローカライズされた詳細が利用できない場合、snippet.localized オブジェクトにはリソースのデフォルト言語のリソースの詳細が含まれます。
  
  たとえば、videos.list リクエストで、上記の動画のデータがローカライズされたドイツ語とスペイン語のデータとともに取得されたとします。hl パラメータが de に設定されている場合、リソースには次のデータが含まれます。
```
{
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    "localized": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    }
    ...
  }
}
```
  ただし、hl パラメータが fr に設定されている場合、snippet.localized オブジェクトには英語のタイトルと説明が含まれます。これは、英語がリソースのデフォルト言語であり、ローカライズされたフランス語の詳細が利用できないためです。
  
  重要: hl パラメータは、YouTube ウェブサイトがサポートするアプリの言語を識別する値のみをサポートします。ローカライズされたテキストが他の言語で利用可能かどうかを判断するには、リソースの localizations 部分を取得し、フィルタしてローカライズされたテキストが存在するかどうかを判断する必要があります。
  
  たとえば、ローカライズされたテキストがアパラチア英語で利用可能かどうかを判断するには、ローカライズの完全なリストを取得する必要があります。
- リソースを取得するときに、part パラメータ値に localizations を含めると、そのリソースのすべてのローカライズされた詳細を取得できます。現在の YouTube アプリケーションの言語以外の言語のローカライズされたデータを取得する場合は、このアプローチを使用してすべてのローカライズを取得し、フィルタして目的のローカライズされたデータが存在するかどうかを判断する必要があります。

ローカライズされたテキスト値に関連するエラー

この API は、ローカライズされたテキスト値に対して次の新しいエラーもサポートしています。

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`defaultLanguageNotSetError`	このエラーは、リソースの `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 の動作の変更を反映したものではありません。
- activities.list メソッドには現在、新しい動画のコメントに関連するリソースが含まれていないことを反映して、activity リソースの説明が更新されました。リソースの 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 メソッドは、以前はコメントとそのコメントへの返信を投稿者の Google+ プロフィールにも投稿するかどうかを示していた shareOnGooglePlus パラメータをサポートしなくなりました。リクエストでパラメータが送信された場合、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`	API ユーザーが `snippet.parentId` プロパティで識別される最上位のコメントへの返信としてコメントを挿入できない場合、`comments.insert` メソッドはこのエラーを返します。`commentThread` リソースの `snippet.canReply` プロパティは、現在の視聴者がスレッドに返信できるかどうかを示します。
`badRequest (400)`	`invalidChannelId`	リクエストの `channelId` パラメータで無効なチャンネル ID が指定された場合、`search.list` メソッドはこのエラーを返します。
`badRequest (400)`	`subscriptionForbidden`	API ユーザーが自分のチャンネルを登録しようとすると、`subscriptions.insert` メソッドはこのエラーを返します。

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

2015 年 4 月 16 日

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

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

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

2015 年 4 月 9 日

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

API の新しい commentThread リソースと comment リソースを使用すると、コメントの取得、挿入、更新、削除、管理を行うことができます。
- commentThread リソースには、YouTube のコメントスレッドに関する情報が含まれています。コメントスレッドは、最上位のコメントと、そのコメントへの返信（存在する場合）で構成されます。commentThread リソースは、動画またはチャンネルに関するコメントを表すことができます。
  
  最上位のコメントと返信は、実際には commentThread リソース内にネストされた comment リソースです。commentThread リソースには、コメントに対するすべての返信が含まれているとは限りません。特定のコメントに対するすべての返信を取得する場合は、comments.list メソッドを使用する必要があります。また、一部のコメントには返信がありません。
  
  API は、commentThread リソースに対して次のメソッドをサポートしています。
  - commentThreads.list - コメントスレッドのリストを取得します。このメソッドを使用して、特定の動画またはチャンネルに関連付けられたコメントを取得します。
  - commentThreads.insert - 新しいトップレベルのコメントを作成します。（既存のコメントに返信するには、comments.insert メソッドを使用します）。
  - commentThreads.update - 最上位のコメントを変更します。
- comment リソースには、単一の YouTube コメントに関する情報が含まれます。comment リソースは、動画またはチャンネルに関するコメントを表すことができます。また、コメントは最上位のコメントまたは最上位のコメントへの返信のいずれかになります。
  
  API は、comment リソースに対して次のメソッドをサポートしています。
  - comments.list - コメントのリストを取得します。このメソッドを使用して、特定のコメントに対するすべての返信を取得します。
  - comments.insert - 既存のコメントへの返信を作成します。
  - comments.update - コメントを変更します。
  - comments.markAsSpam - 1 つ以上のコメントをスパムとして報告します。
  - comments.setModerationStatus - 1 つ以上のコメントの管理ステータスを設定します。たとえば、コメントを一般公開用に承認したり、表示に適さないとしてコメントを拒否したりできます。API リクエストは、コメントに関連付けられているチャンネルまたは動画の所有者によって承認される必要があります。
  - comments.delete - コメントを削除します。
2015 年 4 月 2 日の改訂履歴で説明されているように、API の新しい https://www.googleapis.com/auth/youtube.force-ssl スコープは、comments.insert、comments.update、comments.markAsSpam、comments.setModerationStatus、comments.delete、commentThreads.insert、commentThreads.update メソッドの呼び出しに必要です。
新しいプッシュ通知の登録ガイドでは、ウェブアクセス可能なリソース用のサーバー間パブリッシュ/サブスクライブプロトコルである PubSubHubBub を介したプッシュ通知に対する API の新しいサポートについて説明しています。チャンネルで次のいずれかのアクティビティが行われたときに、PubSubHubBub コールバックサーバーで Atom フィード通知を受信できます。
- 動画をアップロードする
- 動画のタイトルを更新します
- 動画の説明を更新します
移行ガイドも更新され、プッシュ通知の新しいサポートについて記載されています。ただし、v2 API では v3 API で対象外の他の多くの種類のプッシュ通知がサポートされていたため、PubSubHubBub のサポートに関する記述は、そのガイドの非推奨セクションに引き続き記載されています。
API の新しい https://www.googleapis.com/auth/youtube.force-ssl スコープは、以前に https://www.googleapis.com/auth/youtube スコープをサポートしていたすべての API メソッドで有効なスコープになりました。

API で次のエラーがサポートされるようになりました。

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`invalidRating`	リクエストの `rating` パラメータに予期しない値が含まれている場合、`videos.rate` メソッドはこのエラーを返します。

subscriptions.insert メソッドは、以前にリクエストで識別されたサブスクライバーがサブスクリプションのレート制限を超えたことを示していた subscriptionLimitExceeded エラーをサポートしなくなりました。

2015 年 4 月 2 日

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

新しい captions リソースは、YouTube の字幕トラックを表します。字幕トラックは 1 つの YouTube 動画にのみ関連付けられます。

この 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 でサポートされ、v2 API ではサポートされていなかった機能が記載された [v3 API の新機能] という新しいタブがあります。同じ機能は、以前からガイドの他のタブに記載されています。たとえば、チャンネルの InVideo プロモーションキャンペーンのデータを更新する方法を説明する新機能も、[チャンネル（プロフィール）] タブに表示されます。
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 回のリクエストで複数のリソースのリストを取得できます。
これらの変更により、このガイドでは、現在の API バージョン（v3）で非推奨となる古い（v2）API でサポートされていたすべての機能が特定されるようになりました。

2015 年 3 月 4 日

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

channelSections.delete メソッドと channelSections.update メソッドが onBehalfOfContentOwner パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。
次のプロパティとその子プロパティは非推奨になりました。
- brandingSettings.image.backgroundImageUrl
- brandingSettings.image.largeBrandedBannerImageImapScript
- brandingSettings.image.largeBrandedBannerImageUrl
- brandingSettings.image.smallBrandedBannerImageImapScript
- brandingSettings.image.smallBrandedBannerImageUrl
注: これらのプロパティは、API の非推奨ポリシーの対象ではありませんでした。
video リソースの新しい contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons プロパティは、動画が DJCQT（ブラジル）レーティングを受けた理由を特定します。

API で次のエラーがサポートされるようになりました。

エラーのタイプ	エラーの詳細	説明
`notFound (404)`	`channelNotFound`	リクエストの `id` パラメータで指定されたチャンネルが見つからない場合、`channels.update` メソッドはこのエラーを返します。
`badRequest (400)`	`manualSortRequiredinvalidValue`	リクエストでプレイリストアイテムの位置を設定しようとしたが、プレイリストで手動並べ替えが使用されていない場合、`playlistItems.insert` メソッドと `playlistItems.update` メソッドはこのエラーを返します。たとえば、再生リストのアイテムは日付や人気度で並べ替えられます。このエラーを解決するには、リクエスト本文で送信されたリソースから `snippet.position` 要素を削除します。再生リストアイテムをリスト内の特定の位置に配置する場合は、まず再生リストの並べ替え設定を [手動] に更新する必要があります。この設定は YouTube 動画の管理で変更できます。
`forbidden (403)`	`channelClosed`	リクエストの `channelId` パラメータで指定されたチャンネルが閉鎖されている場合、`playlists.list` メソッドはこのエラーを返します。
`forbidden (403)`	`channelSuspended`	リクエストの `channelId` パラメータで一時停止されたチャンネルが指定されている場合、`playlists.list` メソッドはこのエラーを返します。
`forbidden (403)`	`playlistForbidden`	リクエストの `id` パラメータがリクエストをサポートしていない場合、またはリクエストが適切に承認されていない場合、`playlists.list` メソッドはこのエラーを返します。
`notFound (404)`	`channelNotFound`	リクエストの `channelId` パラメータで指定されたチャンネルが見つからない場合、`playlists.list` メソッドはこのエラーを返します。
`notFound (404)`	`playlistNotFound`	リクエストの `id` パラメータで指定されたプレイリストが見つからない場合、`playlists.list` メソッドはこのエラーを返します。
`notFound (404)`	`videoNotFound`	リクエストの `id` パラメータで指定された動画が見つからない場合、`videos.list` メソッドはこのエラーを返します。
`badRequest (400)`	`invalidRating`	リクエストの `rating` パラメータに予期しない値が含まれている場合、`videos.rate` メソッドはこのエラーを返します。

2015 年 3 月 2 日

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

search.list メソッドで relevanceLanguage パラメータがサポートされるようになりました。このパラメータを使用すると、特定の言語に最も関連性の高い結果をリクエストできます。

また、この新しいパラメータの使用方法を説明するために、YouTube Data API（v3）移行ガイドも更新されました。このパラメータは、現在の API バージョン（v3）と以前のバージョン（v2）（すでに非推奨）の間に存在していた機能のギャップに対処します。
また、YouTube Data API（v3）移行ガイドも更新され、v2 API で映画、予告編、テレビ番組、テレビシーズン、テレビエピソードの説明に使用されていた特別なフィードとメタデータフィールドが非推奨になったことが明記されました。

2015 年 1 月 14 日

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

YouTube Data API（v3）移行ガイドが更新され、JavaScript を使用して v3 API で動画をアップロードする方法が説明されています。（詳しくは、動画をアップロードするセクションをご覧ください）。この機能は、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 つのみであることが明記されました。プロモーションアイテムを挿入しすぎると、API は HTTP 400 ステータスコードの tooManyPromotedItems エラーを返します。
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 が見つからないか、プロモーションアイテムとして使用できない場合、`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 × 1,152 ピクセルに縮小されました。（以前の最小サイズは 2120 x 1192 ピクセルでした）。また、channel リソースのドキュメントには、API から配信されるすべてのバナー画像の最大サイズが指定されています。たとえば、テレビアプリケーションの brandingSettings.image.bannerTvImageUrl 画像の最大サイズは 2,120×1,192 ピクセルですが、実際の画像は 2,048×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 プロパティの更新をサポートするようになりました。このプロパティは、プロモーションの表示時にコンテンツ所有者の名前を表示するかどうかを示します。このプロパティは、onBehalfOfContentOwner パラメータを使用してコンテンツ所有者の代理でプロパティ値を設定する API リクエストが行われている場合にのみ設定できます。
playlistItems.list メソッドと playlistItems.insert メソッドが onBehalfOfContentOwner パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。
contentDetails.contentRating.acbRating プロパティで、映画の場合はオーストラリア分類委員会（ACB）、子供向けテレビ番組の場合はオーストラリア通信メディア庁（ACMA）のレーティングを指定できるようになりました。
新しい contentDetails.contentRating.catvRating プロパティと contentDetails.contentRating.catvfrRating プロパティは、それぞれカナダのテレビ分類システムとケベック州で使用されているフランス語の Régie du cinéma レーティングシステムで動画に付けられたレーティングを識別します。
videoCategory リソースの新しい snippet.assignable プロパティは、更新された動画または新しくアップロードされた動画をその動画カテゴリに関連付けることができるかどうかを示します。
次のメソッドのコードサンプルが追加されました。
- activities.insert（Go）
- channelBanners.insert（Python）
- channels.update（Python）
- playlistItems.list（Go）
- search.list（Go）
- thumbnails.set（Java）
- videos.insert（Go）

2013 年 10 月 24 日

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

この API には、ライブ配信コンテンツを見つけて掲載するのに役立つ 2 つの追加機能が含まれています。

検索結果の新しい snippet.liveBroadcastContent プロパティは、動画またはチャンネルリソースにライブ配信コンテンツがあるかどうかを示します。有効なプロパティ値は upcoming、active、none です。
- video リソースの新しい snippet.liveBroadcastContent プロパティは、動画が近日公開のライブ配信か、アクティブなライブ配信かを示します。以下に、プロパティの有効な値を示します。
  - upcoming - 動画はまだ開始されていないライブ配信です。
  - active - 動画はライブ配信中です。
  - none - 動画は近日公開またはアクティブなライブ配信ではありません。これは、YouTube で引き続き視聴できる完了したブロードキャストのプロパティ値になります。
- video リソースの新しい liveStreamingDetails プロパティは、ライブ動画ブロードキャストに関するメタデータを含むオブジェクトです。このメタデータを取得するには、part パラメータ値のリソース部分のリストに liveStreamingDetails を含めます。メタデータには次の新しいプロパティが含まれます。
  - liveStreamingDetails.actualStartTime - ブロードキャストが実際に開始された時刻。（この値は、ブロードキャストの状態が active になると存在します）。
  - liveStreamingDetails.actualEndTime - ブロードキャストが実際に終了した時刻。（この値はブロードキャストが終了すると表示されます）。
  - liveStreamingDetails.scheduledStartTime - ブロードキャストの開始予定時刻。
  - liveStreamingDetails.scheduledEndTime - ブロードキャストの終了予定時刻。プロパティ値が空の場合、またはプロパティが存在しない場合、ブロードキャストは無期限に継続するようにスケジュールされます。
  - liveStreamingDetails.concurrentViewers - ライブ配信を視聴しているユーザーの数。
  このメタデータを取得するには、videos.list、videos.insert、または videos.update メソッドを呼び出すときに、part パラメータ値に liveStreamingDetails を含めます。
なお、ライブ放送コンテンツを識別するための他の 2 つの機能（search.list メソッドの eventType パラメータと検索結果の snippet.liveBroadcastContent プロパティ）は、2013 年 10 月 1 日にリリースされています。
videos.insert メソッドで notifySubscribers パラメータがサポートされるようになりました。このパラメータは、新しい動画に関する通知を動画のチャンネルに登録しているユーザーに送信するかどうかを YouTube に指示します。パラメータのデフォルト値は 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 プロパティで、pg14（TV-14 評価に対応）の値がサポートされるようになりました。
検索結果の一部である 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 の値がサポートされるようになりました。これは、プロモーション対象のアイテムが指定されたチャンネルの最新のアップロード動画であることを示します。

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

API で次のエラーがサポートされるようになりました。

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

2013 年 8 月 27 日

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

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

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

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

2013 年 8 月 8 日

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

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

2013 年 7 月 30 日

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

channelBanner リソースで、kind プロパティの値が youtube#channelBannerInsertResponse から youtube#channelBannerResource に変更されました。このリソースは、channelBanners.insert リクエストに対するレスポンスで返されます。
channel リソースの新しい brandingSettings.channel.profileColor プロパティは、チャンネルのコンテンツを補完する目立つ色を指定します。プロパティ値は、番号記号（#）の後に 6 文字の 16 進文字列が続いたものです（#2793e6 など）。
この API で、チャンネルのすべてのアクティビティを対象とするか、新しいアップロードのみを対象とするかを指定できるようになりました。subscription リソースの新しい contentDetails.activityType プロパティは、サブスクライバーに通知されるアクティビティのタイプを識別します。有効なプロパティ値は all と uploads です。
videos.list メソッドは、YouTube で最も人気のある動画のチャートを取得するための新しいパラメータをサポートしています。
- chart パラメータは、取得するグラフを識別します。現在サポートされている値は mostPopular のみです。chart パラメータはフィルタパラメータであるため、他のフィルタパラメータ（id、myRating）と同じリクエストで使用することはできません。
- videoCategoryId パラメータは、グラフを取得する動画カテゴリを指定します。このパラメータは、chart パラメータと組み合わせてのみ使用できます。デフォルトでは、グラフは特定のカテゴリに制限されません。
video リソースの新しい topicDetails.relevantTopicIds[] プロパティは、動画またはそのコンテンツに関連する Freebase トピック ID のリストを提供します。これらのトピックの対象は、動画で言及されたり、動画に登場したりする可能性があります。
video リソースの recordingDetails.location.elevation プロパティの名前が recordingDetails.location.altitude に変更され、fileDetails.recordingLocation.location.elevation プロパティの名前が fileDetails.recordingLocation.location.altitude に変更されました。
video リソースの contentDetails.contentRating オブジェクトは、MPAA レーティングや TVPG レーティングなど、さまざまなレーティングスキームで動画に付けられたレーティングを指定します。各レーティングシステムについて、動画がレーティングされていないことを示すレーティング値が API でサポートされるようになりました。MPAA レーティングの場合、「unrated」レーティングは、カット版が公式レーティングを受けている映画のノーカット版を識別するために頻繁に使用されます。
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`	`activities.list` メソッドは、リクエストで `home` パラメータが使用されているが、適切に承認されていない場合にこのエラーを返します。

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 オブジェクトがサポートされるようになりました。このオブジェクトは、チャンネルに関連付けられたプロモーションキャンペーンに関する情報をカプセル化します。チャンネルは、InVideo プロモーションキャンペーンを使用して、チャンネルの動画の再生中に、動画プレーヤー内にプロモート動画のサムネイル画像を表示できます。

このデータを取得するには、channels.list リクエストの part パラメータ値に invideoPromotion を含めます。
新しい channels.update メソッドを使用して、チャネルの InVideo プロモーションキャンペーンのデータを更新できます。このメソッドは 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 オブジェクトは、さまざまなレーティングスキームで動画が受けたレーティングをカプセル化します。以下のリストは、サポートされているレーティングシステムと、各レーティングシステムに関連付けられているプロパティへのリンクを示しています。プロパティ定義では、各システムでサポートされているレーティング値が特定されます。

国	レーティングシステム	プロパティ
`United States`	アメリカ映画協会（MPAA）	`contentDetails.contentRating.mpaaRating`
`United States`	テレビのペアレンタルガイドライン	`contentDetails.contentRating.tvpgRating`
`Australia`	Australian Classification Board（ACB）	`contentDetails.contentRating.acbRating`
`Brazil`	Departamento de Justiça, Classificação, Qualificação e Títulos	`contentDetails.contentRating.djctqRating`
`Canada`	カナダのホームビデオレーティングシステム（CHVRS）	`contentDetails.contentRating.chvrsRating`
`France`	Centre national du cinéma et de l'image animée（フランス文化省）	`contentDetails.contentRating.fmocRating`
`Germany`	Freiwillige Selbstkontrolle der Filmwirtschaft（FSK）	`contentDetails.contentRating.fskRating`
`Great Britain`	英国映画分類委員会（BBFC）	`contentDetails.contentRating.bbfcRating`
`India`	中央映画認証委員会（CBFC）	`contentDetails.contentRating.cbfcRating`
`Japan`	映倫管理委員会 (EIRIN)	`contentDetails.contentRating.eirinRating`
`Korea`	영상물등급위원회（KMRB）	`contentDetails.contentRating.kmrbRating`
`Mexico`	ラジオ、テレビ、映画総局（RTC）	`contentDetails.contentRating.rtcRating`
`New Zealand`	Office of Film and Literature Classification	`contentDetails.contentRating.oflcRating`
`Russia`	ロシア連邦国立フィルム登録簿	`contentDetails.contentRating.russiaRating`
`Spain`	`Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)`	`contentDetails.contentRating.icaaRating`

snippet.resourceId プロパティはリクエスト本文として送信されるリソースで指定する必要があることを反映するため、playlistItems.update メソッドのドキュメントが更新されました。
search.list メソッドで次の機能がサポートされるようになりました。
- 新しい forMine パラメータは、認証済みユーザーの動画のみを取得するように検索を制限します。
- order パラメータで、結果をタイトル（order=title）または動画数（order=videoCount）でアルファベット順に並べ替えることができるようになりました。
- 新しい safeSearch パラメータは、検索結果に制限付きコンテンツを含めるかどうかを示します。

videos.insert メソッドは、次の表に示すように、いくつかの新しいエラーをサポートしています。

エラーのタイプ	エラーの詳細	説明
`badRequest`	`invalidCategoryId`	`snippet.categoryId` プロパティで無効なカテゴリ ID が指定されています。`videoCategories.list` メソッドを使用して、サポートされているカテゴリを取得します。
`badRequest`	`invalidRecordingDetails`	`metadata` は、無効な録音の詳細を指定します。
`badRequest`	`invalidVideoGameRating`	リクエストメタデータで指定されたビデオゲームの評価は無効です。
`badRequest`	`invalidVideoMetadata`	リクエストメタデータが無効です。

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

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 の進捗状況に関する情報が含まれています。オブジェクトのプロパティは、現在の処理ステータスを特定し、YouTube が動画の処理を完了するまでの残り時間を推定します。また、この部分は、ファイルの詳細やサムネイル画像など、さまざまなタイプのデータやコンテンツを動画で利用できるかどうかも示しています。
    このオブジェクトは、動画アップローダーがアップロードされた動画ファイルの処理における YouTube の進捗状況を追跡できるように、ポーリングされるように設計されています。
  - suggestions オブジェクトには、アップロードされた動画の画質やメタデータを改善する機会を特定する提案が含まれています。
- contentDetails 部分には、4 つの新しいプロパティが含まれています。これらのプロパティは、認証されていないリクエストで取得できます。
  - dimension - 動画が 2D または 3D で利用できるかどうかを示します。
  - definition - 動画が標準画質または高画質で利用可能かどうかを示します。
  - caption - 動画で字幕を利用できるかどうかを示します。
  - licensedContent - YouTube コンテンツパートナーから申し立てを受けたコンテンツが動画に含まれているかどうかを示します。
- status 部分には 2 つの新しいプロパティが含まれています。動画の所有者は、動画の挿入時または更新時に両方のプロパティの値を設定できます。これらのプロパティは、認証されていないリクエストでも取得できます。
  - embeddable - 動画を別のウェブサイトに埋め込むことができるかどうかを示します。
  - license - 動画のライセンスを指定します。有効な値は creativeCommon と youtube です。
videos.list、videos.insert、videos.update メソッドの part パラメータの定義が更新され、上記で説明した新しく追加された部分と、誤って省略されていた recordingDetails 部分が一覧表示されるようになりました。
channel リソースの新しい contentDetails.googlePlusUserId プロパティは、チャンネルに関連付けられた Google+ プロフィール ID を指定します。この値を使用して、Google+ プロファイルへのリンクを生成できます。
各サムネイル画像オブジェクトで、画像の幅と高さを指定できるようになりました。現在、サムネイル画像は activity、channel、playlist、playlistItem、search result、subscription、video の各リソースで返されます。
playlistItems.list で videoId パラメータがサポートされるようになりました。このパラメータを playlistId パラメータと組み合わせて使用すると、指定された動画を表すプレイリストアイテムのみを取得できます。

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

2013 年 1 月 30 日

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

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

2013 年 1 月 16 日

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

次のリストに示すメソッドと言語のコードサンプルが利用可能になりました。
- activities.insert - Java
- playlistItems.insert - Python
- playlistItems.list - Java、JavaScript、PHP、Python、Ruby
- playlists.insert - Java、JavaScript、Python
- search.list - Java、JavaScript、Python、Ruby
- videos.insert - Java
activity リソースで、channelItem アクションをレポートできるようになりました。このアクションは、YouTube が自動生成された YouTube チャンネルに動画を追加したときに発生します。（YouTube のアルゴリズムは、YouTube ウェブサイトで存在感のあるトピックを特定し、それらのトピックのチャンネルを自動的に生成します）。
次の search.list パラメータが更新されました。
- q パラメータはフィルタとして指定されなくなりました。つまり、....
- relatedToVideo パラメータの名前が relatedToVideoId に変更されました。
- published パラメータは、以下で説明する 2 つの新しいパラメータ publishedAfter と publishedBefore に置き換えられました。

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

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

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

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

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

2026 年 9 月 30 日

2026 年 9 月 14 日

2026 年 9 月 11 日

2026 年 9 月 1 日

2026 年 8 月 27 日

2026 年 8 月 6 日

2026 年 7 月 7 日

2026 年 6 月 23 日

2026 年 6 月 3 日

2026 年 6 月 1 日

2025 年 12 月 4 日

2025 年 7 月 10 日

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 日

変更履歴