変更履歴

このページでは、YouTube Data API(v3)の変更点とドキュメントの更新内容の一覧を示します。この変更履歴に登録します。チャンネル登録

2023 年 11 月 9 日

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

2023 年 9 月 12 日

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

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

comments.markAsSpam メソッドを参照するすべてのドキュメントに、サポート終了のお知らせを追加しました。

2023 年 8 月 22 日

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

2023 年 8 月 18 日

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

2023 年 8 月 7 日

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

2023 年 6 月 28 日

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

2023 年 6 月 12 日

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

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

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

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

2022 年 8 月 22 日

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

2022 年 8 月 5 日

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

現在から 2022 年 12 月 1 日まで、captions.listcaptions.updatecaptions.downloadcaptions.delete の各メソッドは新旧両方の字幕トラック ID をサポートします。ただし、2022 年 12 月 1 日以降、YouTube は古い字幕トラック ID のサポートを終了します。その時点で古い字幕トラック ID で API メソッドを呼び出すと、captionNotFound エラーが発生します。

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

2022 年 7 月 12 日

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

2022 年 4 月 27 日

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

2022 年 4 月 8 日

subscriptions.list メソッドの myRecentSubscribersmySubscribers の両方のパラメータの定義が更新され、API から返されるサブスクライバーの最大数が制限される可能性があることに注意しました。 この変更は、API の動作の変更ではなく、ドキュメントを修正するためのものです。

2021 年 12 月 15 日

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

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

2021 年 11 月 18 日

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

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

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

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

2021 年 7 月 2 日

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

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

メソッドと、コードに commentThreads リソースが必要な場合は、commentThreads.list メソッドの二次呼び出しを行います。

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 管理画面と YouTube ですでにサポートされていません。そのため、API によるサポート対象外になりました。

    • brandingSettings.channel.defaultTab
    • brandingSettings.channel.featuredChannelsTitle
    • brandingSettings.channel.featuredChannelsUrls[]
    • brandingSettings.channel.profileColor
    • brandingSettings.channel.showBrowseView
    • brandingSettings.channel.showRelatedChannels

    すべてのプロパティが channel リソース表現から削除され、それらの定義がリソースのプロパティ リストから削除されました。また、これらのプロパティに関連するエラーは、メソッド固有のドキュメントから削除されました。

  • 次の channelSection リソース プロパティは非推奨になりました。これらのプロパティは、YouTube Studio 管理画面と 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.deleteplaylistItems.insertplaylistItems.listplaylistItems.updateplaylists.deleteplaylists.listplaylists.update のメソッドはすべて、新しい playlistOperationUnsupported エラーをサポートしています。このエラーは、特定の再生リストで許可されていない操作をリクエストが実行しようとした場合に発生します。たとえば、ユーザーがアップロードした動画の再生リストから動画を削除したり、再生リストそのものを削除したりすることはできません。

    いずれの場合も、400 HTTP レスポンス コード(不正なリクエスト)が返されます。

  • playlistItems.list メソッドの watchHistoryNotAccessible エラーと watchLaterNotAccessible エラーがドキュメントから削除されました。実際には、ユーザーの再生履歴と [後で見る] のリストに API からアクセスすることはできませんが、このような特定のエラーは API から返されません。

2020 年 10 月 15 日

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

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

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

この変更と合わせて、埋め込みプレーヤー パラメータのドキュメントに注意書きを追加しました。自動再生を有効にした場合、ユーザーによる操作なしで再生が行われること。そのため、ページ読み込み時に再生データの収集と共有が行われることを説明します。

2020 年 10 月 8 日

この更新では、channel リソースに関する次の 3 つの軽微な変更が行われています。

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

2020 年 9 月 9 日

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

この更新は、次の API の変更を対象としています。すべての変更は、この発表日である 2020 年 9 月 9 日以降に適用されます。そのため、デベロッパーは以下の API 機能に依存しないようにする必要があります。

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

2020 年 7 月 29 日

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

この変更の影響は、ほとんどの API 呼び出しでクォータ コストが若干削減されますが、一部の API 呼び出しではコストが変わらないというものです。この変更によって API 呼び出しのコストが増えることはありません。全体として見ると、Google Cloud コンソール に表示される割り当てが、やや少なくなる可能性があります。

YouTube API サービスに引き続きアクセスできるようにするため、すべてのデベロッパーにプロジェクトのコンプライアンス監査を実施することを強くおすすめします。

この変更履歴のエントリは、2020 年 7 月 20 日に最初に公開されたものです。

2020 年 7 月 28 日

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

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

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

2020 年 7 月 21 日

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

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

2020 年 7 月 7 日

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

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

2020 年 6 月 15 日

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

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

2020 年 6 月 4 日

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

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

2020 年 4 月 17 日

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

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

2020 年 3 月 31 日

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

  • 新しいリソースとメソッド

    • 新しい member リソースは、YouTube チャンネルのチャンネル メンバーを表します。メンバーはクリエイターに定期的な金銭的サポートを提供し、特別な特典を受けることができます。たとえば、クリエイターがチャットに対してメンバー限定モードをオンにしている場合、メンバーはチャットを行うことができます。

      このリソースは、YouTube Live Streaming API の一部としてドキュメント化されている sponsor リソースに代わるものです。sponsor リソースは非推奨になりました。API クライアントは sponsors.list メソッドの呼び出しを更新して、代わりに members.list メソッドを使用する必要があります。

    • 新しい membershipsLevel リソースは、API リクエストを承認した作成者が管理する料金レベルを識別します。membershipsLevels.list メソッドは、クリエイターのメンバーシップ レベルの一覧を取得します。

2020 年 1 月 10 日

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

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

  • コンテンツ作成者は selfDeclaredMadeForKids プロパティを使用して、チャンネル動画のどちらが子ども向けに制作されたかを指定できます。

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

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

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

2019 年 9 月 10 日

API リファレンス ドキュメントを更新し、YouTube とそれに伴う API レスポンスにおけるチャンネル登録者数のレポート方法の変更を反映しました。この変更に伴い、チャンネル登録者数が 1,000 人を超える場合、YouTube Data API サービスで返されるチャンネル登録者数は有効数字 3 桁に切り捨てられます。この変更は、channel リソースの statistics.subscriberCount プロパティに影響します。

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

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

チャンネル登録者数の例 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 つの新しい要素が追加されました。

    • APIs 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 で利用可能なコードサンプルを掲載していたページが削除されました。

  • JavaJavaScriptPHPPython のクイックスタート ガイドが更新されました。改訂後のガイドでは、API キーを使用してサンプルを実行する方法と、OAuth 2.0 クライアント ID を使用して API Explorer のコードサンプルを使用して別のサンプルを実行する方法を説明しています。

上記の変更は、2017 年に API ドキュメントに追加された対話型ツールに代わるものです。

2018 年 7 月 9 日

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

  • channel リソースの snippet.thumbnails プロパティの定義が更新され、アプリでサムネイルを表示する場合、API レスポンスで返される画像 URL とまったく同じ画像をコードで使用する必要があることに注意しました。たとえば、アプリケーションでは API レスポンスで返される URL に https ドメインではなく http ドメインを使用しないでください。

    2018 年 7 月より、チャンネルのサムネイル URL は https ドメインでのみ利用できます。この URL は API レスポンスに表示されます。10 営業日が経過すると、アプリケーションが http ドメインから YouTube 画像を読み込もうとすると、破損した画像がアプリケーションに表示される場合があります。

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

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

2018 年 6 月 22 日

実装ガイド(旧称「実装および移行ガイド」)を更新し、v2 API から v3 API に移行する手順を削除しました。また、お気に入りの動画など、v3 API でサポートが終了した機能の手順も削除されています。

2017 年 11 月 27 日

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

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

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

    invideoPromotion データの取得と設定は 2017 年 12 月 14 日まで可能です。この日以降は、次のようになります。

    • channels.list の呼び出し時に invideoPromotion 部分を取得しようとすると、空の invideoPromotion が返されるか、invideoPromotion データがまったく返されません。
    • channels.update を呼び出したときに invideoPromotion データを更新しようとすると、少なくとも 2018 年 5 月 27 日までは成功のレスポンスが返されますが、NoOps として扱われるため、実際には更新は行われません。

    2018 年 5 月 27 日以降、これらのリクエストからエラー メッセージが返される場合があります(たとえば、invalidPromotion が無効な部分であるなど)。

2017 年 11 月 16 日

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

  • インタラクティブ コード スニペット ツールで Node.js コードサンプルがサポートされるようになりました。サンプルは、channels.list メソッドなど、ほぼすべての API メソッドのドキュメントでも確認できます。

    カスタマイズ可能なサンプルは、Node.js アプリケーションのユースケース固有の出発点となるように設計されています。この機能は、Node.js クイックスタート ガイドのコードに似ています。ただし、サンプルにはクイックスタートには表示されないユーティリティ関数が含まれています。

    • removeEmptyParameters 関数は、API リクエスト パラメータに対応する Key-Value ペアのリストを受け取り、値を持たないパラメータを削除します。
    • createResource 関数は、API リソース内のプロパティに対応する Key-Value ペアのリストを受け取ります。次に、プロパティを insert オペレーションと update オペレーションで使用できる JSON オブジェクトに変換します。以下の例は、プロパティ名と値のセット、およびコードによって作成される JSON オブジェクトを示しています。
      # Key-value pairs:
      {'id': 'ABC123',
       'snippet.title': 'Resource title',
       'snippet.description': 'Resource description',
       'status.privacyStatus': 'private'}
      
      # JSON object:
      {
       'id': 'ABC123',
       'snippet': {
         'title': 'Resource title',
         'description': 'Resource description',
       },
       'status': {
         'privacyStatus': 'private'
       }
      }

    以下のサンプルはすべて、ローカルにダウンロードして実行するように設計されています。詳細については、コード スニペット ツールの手順で完全なコードサンプルをローカルで実行する場合の前提条件をご覧ください。

2017 年 10 月 25 日

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

  • インタラクティブ コード スニペット ツールの Python コードサンプルが更新され、サポートが終了した oauth2client ライブラリの代わりに google-auth ライブラリと google-auth-oauthlib ライブラリが使用されるようになりました。

    この変更に加えて、このツールでは、インストール済みの Python アプリケーションと Python ウェブサーバー アプリケーションの完全なコードサンプルを提供するようになりました。これらのアプリケーションでは、認証フローが若干異なります。サンプル全体(およびこの変更)を表示するには:

    1. インタラクティブ コード スニペット ツール、または API メソッド(channels.list メソッドなど)のドキュメントをご覧ください。
    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 日

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

2017 年 5 月 17 日

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

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

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

    コードサンプルを操作することもできます。

    • パラメータ値とプロパティの値を変更すると、コード スニペットが動的に更新されて指定した値が反映されます。

    • コード スニペットと完全なサンプルの表示を切り替えることができます。コード スニペットは、コードのうち API メソッドを呼び出す部分を示しています。完全なサンプルには、このスニペットと、リクエストを認可および送信するためのボイラープレート コードが含まれています。完全なサンプルは、コマンドラインまたはローカル ウェブサーバーからコピーして実行できます。

    • ボタンをクリックしてリクエストを実行します。(リクエストを実行するには、ユーザーに代わって API を呼び出すツールを承認する必要があります)。

    なお、API Explorer を利用可能なページで、このツールが API Explorer に代わるものです。(各ページにはリンクが表示され、API Explorer で作業中のリクエストを読み込むオプションもあります)。

  • Data API コード スニペット ツールも更新され、上記の機能をすべて利用できる新しい UI が導入されました。このページで利用できる主な新機能は次のとおりです。

    • データを書き込む API リクエストをサポートします。
    • Java サンプルのサポート。
    • ユーザー認証と API リクエストの作成のための、より柔軟で包括的なボイラープレート コード。

2017 年 4 月 27 日

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

  • 新しいクイックスタート ガイドでは、YouTube Data API リクエストを行う簡単なアプリケーションをセットアップする方法を説明しています。現在、AndroidApps ScriptGoJavaJavaScriptNode.jsPHPPythonRuby 向けのガイドが提供されています。

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
  • Animated cartoon トピック(以前は Entertainment の子)が削除されました。
  • Children's music トピック(以前は Music の子)が削除されました。

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

2016 年 11 月 29 日

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

  • 2017 年 2 月 10 日より、トピック ID のリストに次の 3 つの小さな変更が加えられます。

    • これまで Sports カテゴリの子だった Professional wrestling カテゴリは、Entertainment の子になりました。
    • Entertainment の子である TV shows カテゴリは新しいカテゴリです。
    • Health カテゴリ(以前は Lifestyle の子)が削除されました。

    また、親カテゴリもいくつかあります(EntertainmentGamingLifestyleMusicSports)。子カテゴリに関連付けられている動画(例: 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[] プロパティ。このプロパティは 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 メソッドは、maxHeightmaxWidth の 2 つの新しいパラメータをサポートしています。video リソースの player 部分を取得する際に、どちらか一方または両方のパラメータを使用できます。

      デフォルトでは、player.embedHtml プロパティで返される <iframe> の高さは 360 ピクセルです。幅は動画のアスペクト比に合わせて調整されるため、埋め込みプレーヤーの動画に黒い帯が表示されなくなります。たとえば、動画のアスペクト比が 16:9 の場合、プレーヤーの幅は 640 ピクセルになります。

      新しいパラメータを使用すると、デフォルトのサイズの代わりに、アプリのレイアウトに適した高さや幅を埋め込みコードで指定できます。API サーバーは、埋め込みプレーヤーの動画に黒い帯が表示されないよう、必要に応じてプレーヤーのサイズを調整します。どちらのパラメータも、埋め込みプレーヤーの最大サイズを指定します。そのため、両方のパラメータを指定しても、一方のディメンションはそのディメンションで許容される最大数よりも小さくなることがあります。

      たとえば、動画のアスペクト比が 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 プロパティは、grfilmK12grfilmK15grfilmK18 の 3 つの追加値をサポートします。

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

  • 新しいエラーと更新エラー

    • API では、次の新しいエラーがサポートされています。

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

  • その他の最新情報

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

2016 年 9 月 15 日

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

  • 2016 年 8 月 11 日の変更履歴の更新では、トピック ID に関連するいくつかの変更点について説明しました。その中には、サポートされるトピック ID のセットが 2017 年 2 月 10 日より変更されるという事実が含まれます。サポートされるトピックのリストは、2016 年 11 月 10 日までに公開されます。

  • 以下の変更が有効になりました。この変更については、2016 年 8 月 11 日の変更履歴でお知らせしています。

    • home パラメータを true に設定して activities.list メソッドを呼び出すと、ログアウトした YouTube ユーザーがホームページに表示するものと同様のアイテムが API レスポンスに含まれるようになりました。

      これは、2016 年 8 月 11 日の変更履歴の更新で説明されている動作よりも優れたユーザー エクスペリエンスを提供するための、若干の変更です。この更新では、home パラメータを使用するリクエストは空のリストを返すと記載されていました。

    • channel リソースの contentDetails.relatedPlaylists.watchHistory プロパティと contentDetails.relatedPlaylists.watchLater プロパティには、すべてのチャネルについてそれぞれ HLWL の値が含まれるようになりました。

      なお、これらのプロパティを表示できるのは、自分のチャンネルに関するデータを取得する承認済みユーザーのみです。承認済みユーザーが自身のチャンネルに関するデータを取得する場合でも、このプロパティには常に HLWL の値が含まれます。そのため、再生履歴と [後で見る] の再生リスト ID を API で取得することはできません。

      また、チャンネルの再生履歴または [後で見る] 再生リストについて、再生リストの詳細(playlists.list)や再生リストのアイテム(playlistItems.list)を取得するリクエストに対して、空のリストが返されるようになりました。この動作は、新しい値 HLWL だけでなく、API クライアントがすでに保存した再生履歴や [後で見る] 再生リスト ID にも当てはまります。

  • video リソースの fileDetails.recordingLocation オブジェクトとその子プロパティは返されなくなります。これまでは、このデータ(親 fileDetails オブジェクトなど)は動画の所有者だけが取得できました。

2016 年 8 月 11 日

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

  • 新たに公開された YouTube API サービス利用規約(「更新された規約」)には、現在の利用規約に加えられた更新内容が多く含まれています。詳しくは YouTube エンジニアリングとデベロッパー ブログをご覧ください。2017 年 2 月 10 日から施行される更新された利用規約に加えて、この更新には、デベロッパーが準拠する必要があるポリシーを説明する際に役立ついくつかの補足ドキュメントが含まれています。

    新しいドキュメントの全セットは、更新後の本規約の変更履歴に記載されています。また、更新後の本規約または補足書類に対する今後の変更についても、その改訂履歴に記載されます。ドキュメント内のリンクから、変更履歴の変更内容をリストした RSS フィードに登録できます。

  • Freebase と Freebase API のサポート終了に伴い、トピック ID に関していくつかの変更が行われています。トピック ID は、次の API リソースとメソッドで使用されます。

    • channel リソースの topicDetails 部分は、チャンネルに関連付けられたトピックを識別します。
    • video リソースの topicDetails 部分は、動画に関連付けられているトピックを識別します。
    • search.list メソッドの topicId パラメータを使用すると、特定のトピックに関連する動画やチャンネルを検索できます。

    これらの機能の変更点は次のとおりです。

    • 2017 年 2 月 10 日より、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.watchHistoryHL の値を返し、contentDetails.relatedPlaylists.watchLater プロパティの値はすべてのチャネルについて WL の値を返します。

      2016 年 9 月 12 日以降、チャンネルの再生履歴または [後で見る] 再生リストについて、再生リストの詳細(playlists.list)を取得するリクエストに対して、空のリストが返されます。これらのプレイリストのいずれかに含まれるプレイリスト アイテム(playlistItems.list)を取得するリクエストも、それ以降は空のリストを返します。これは、新しい値 HLWL のほかに、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 パラメータを使用します。このパラメータは特定の順序で定期購読者を返さないため、取得できる登録者の数は制限されません。

  • activityplaylistItemplaylistsearch resultthumbnailvideo の各リソースの snippet.thumbnails.(key) プロパティの定義が更新され、一部の動画で追加のサムネイル画像サイズが利用できるようになりました。

    • standard の画像は、幅 640 ピクセル、高さ 480 ピクセルです。
    • maxres の画像は、幅 1,280 ピクセル、高さ 720 ピクセルです。
  • channelSection.list メソッドの part パラメータの定義を更新し、targeting 部分は 2 割り当てユニットの費用で取得できることを記載しました。

  • videos.list メソッドは、権限が適切でないリクエストが video リソースの fileDetailsprocessingDetails、または suggestions 部分を取得しようとしたときに、forbidden403)エラーを返すようになりました。これらの部分は、動画の所有者のみが利用できます。

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 プロパティには、動画の投影形式を指定します。有効な値は 360rectangular です。

  • video リソースの recordingDetails.location プロパティと fileDetails.recordingLocation プロパティは、どちらも更新され、2 つのプロパティの違いが説明されています。

    • recordingDetails.location プロパティは、動画の所有者が動画に関連付ける場所を識別します。この場所は編集可能で、公開動画の場合は検索可能です。また、公開動画の場合はユーザーに表示される場合があります。
    • fileDetails.recordingLocation プロパティ値は不変で、アップロードされた元の動画ファイルに関連付けられた場所を表します。この値は動画所有者にのみ表示されます。

  • channel リソースの contentDetails.relatedPlaylists.favorites プロパティの定義を更新し、プロパティ値に空の再生リストを参照する再生リスト ID が含まれている可能性があることに注意してください。この ID は取得できません。これは、お気に入りの動画の機能がすでに廃止されているためです。このプロパティは API 非推奨ポリシーの対象ではありません

  • comments.insertcomments.updatecommentThreads.insert、または commentThreads.update メソッドによって返される ineligibleAccount エラーの定義を更新し、API リクエストの認可に使用された YouTube アカウントがユーザーの Google アカウントと統合されていない場合に発生することを反映しました。

2016 年 4 月 20 日

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

  • channels.update メソッドの part パラメータの定義が更新され、localizations もこのパラメータの有効な値であることにご注意ください。

  • スタートガイドの割り当て使用量セクションが更新され、Google Developer Console にリンクされ、実際の割り当てと割り当て使用量を確認できるようになりました。

2016 年 3 月 16 日

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

  • 既存のリソースとメソッドの更新

    • channelBanner リソース ドキュメントが更新され、アップロードするチャンネル バナー画像の推奨サイズが 2,560 x 1,440 ピクセルであることを明記しました。最小サイズ(2048 x 1152 ピクセル)は変更されていません。

    • channel リソースの新しい snippet.customUrl プロパティは、チャネルに関連付けられたカスタム URL を識別します。(カスタム URL がないチャネルもあります)。YouTube ヘルプセンターでは、カスタム URL を取得するための資格要件と URL の設定方法について説明しています。

    • channel リソースの brandingSettings.watch オブジェクトとすべての子プロパティが非推奨になりました。

    • search.list リクエストに対する API レスポンスに regionCode プロパティが追加されました。プロパティは、検索クエリに使用された地域コードを識別します。地域コードは、指定された国の検索結果を返すように API に指示します。

      プロパティ値は、地域を識別する 2 文字の ISO 国コードです。i18nRegions.list メソッドは、サポートされているリージョンのリストを返します。デフォルト値は US です。サポートされていない地域が指定されていても、YouTube はクエリを処理するために、デフォルト値ではなく別の地域を選択することがあります。

    • videoAbuseReportReason リソースの snippet.label プロパティと snippet.secondaryReasons[].label プロパティの定義を更新し、不正行為の報告の理由から、プロパティにローカライズされたラベルテキストが含まれていることを記載しました。

      また、videoAbuseReportReasons.list メソッドは hl パラメータをサポートするようになりました。このパラメータでは、API レスポンスのラベルテキストに使用する言語を指定します。デフォルトのパラメータ値は en_US です。

    • video リソースの新しい contentDetails.contentRating.ecbmctRating プロパティは、トルコの文化観光省の評価および分類委員会による動画の評価を指定します。

      また、他のレーティング システムの API プロパティでは、次の新しいプロパティ値がサポートされています。

      • contentDetails.contentRating.fpbRating(南アフリカ)
        評価: 10、プロパティ値: fpb10
      • contentDetails.contentRating.moctwRating(台湾)
        評価: R-12、プロパティ値: moctwR12
      • contentDetails.contentRating.moctwRating(台湾)
        評価: R-15、プロパティ値: moctwR15
    • video リソースの liveStreamingDetails.activeLiveChatId プロパティには、動画に関連付けられているアクティブなチャットの ID が含まれます。このプロパティ値は、動画が現在のライブ配信であり、チャットが有効である場合にのみ存在します。配信とチャットが終了すると、動画のプロパティは返されなくなります。

    • video リソースの status.rejectionReason プロパティは、新しいプロパティ値 legal をサポートしています。

  • API では、次の新しいエラーがサポートされています。

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

2015 年 12 月 18 日

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

2015 年 11 月 19 日

API で、playlist リソースと video リソースの snippet.title プロパティと snippet.description プロパティ、channelSection リソースの snippet.title プロパティ、channel リソースの snippet.description プロパティについて、ローカライズされたテキストを設定および取得できるようになりました。

  • ローカライズしたタイトルと説明の設定

    リソースのローカライズされた値を設定するには、そのリソースの insert メソッドまたは update メソッドを呼び出します。リソースにローカライズされた値を設定するには、次の両方を行います。

    • リソースの snippet.defaultLanguage プロパティに値が設定されていることを確認します。このプロパティは、リソースの snippet.title プロパティと snippet.description プロパティの言語を識別します。値には、サポートされているアプリケーション言語や他のほとんどの ISO 639-1:2002 言語コードを指定できます。たとえば、英語のタイトルと説明の動画をアップロードする場合は、snippet.defaultLanguage プロパティを en に設定します。

      channel リソースの更新に関する注意: channel リソースの snippet.defaultLanguage プロパティを設定するには、実際には brandingSettings.channel.defaultLanguage プロパティを更新する必要があります。

    • 更新するリソースに localizations オブジェクトを追加します。各オブジェクト キーは、アプリケーション言語または ISO 639-1:2002 言語コードを識別する文字列です。各キーは、リソースのローカライズされたタイトル(および説明)を含むオブジェクトにマッピングされます。

      以下のサンプル スニペットでは、リソースのデフォルト言語を英語に設定しています。また、ローカライズしたドイツ語とスペイン語のタイトルと説明を動画に追加します。

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          ...
        },
        "localizations":
          "de": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          },
          "es": {
            "title": "Jugar al fútbol",
            "description": "Nosotros jugamos fútbol en el parque los domingos",
          }
        }
      }
    • 重要: リソースのローカライズ済みデータを更新する場合、API リクエストに既存のローカライズ済みバージョンのデータがすべて含まれている必要があります。たとえば、上記の例で、動画にポルトガル語のデータを追加する後続のリクエストを送信した場合、そのリクエストにドイツ語、スペイン語、ポルトガル語にローカライズされたデータを含める必要があります。

  • ローカライズされた値の取得

    API では、次の 2 つの方法でリソースのローカライズされた値を取得できます。

    • hl パラメータを channels.listchannelSections.listplaylists.listvideos.list のリクエストに追加して、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 アプリケーションの現在の言語ではない言語のローカライズ データを取得する場合は、この方法を使用してすべてのローカライズを取得してから、フィルタを使用して目的のローカライズ データが存在するかどうかを判断する必要があります。

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

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

    エラーのタイプ エラーの詳細 説明
    badRequest (400) defaultLanguageNotSetError このエラーは、リソースの snippet.defaultLanguage プロパティが設定されていないため、そのリソースの localizations オブジェクトを挿入または更新しようとするリクエストが失敗したことを示します。channels.updatechannelSections.insertchannelSections.updateplaylists.insertplaylists.updatevideos.insertvideos.update メソッドは、このエラーをサポートします。
    badRequest (400) localizationValidationError このエラーは、リソースの localizations オブジェクト内の値の 1 つが検証できなかったことを示します。このエラーは、たとえばオブジェクトに無効な言語コードが含まれている場合に発生することがあります。channels.updatechannelSections.insertchannelSections.updateplaylists.insertplaylists.update の各メソッドは、このエラーをサポートします。

2015 年 11 月 4 日

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

  • 既存のリソースとメソッドの更新

    • search.list メソッドの order パラメータが更新され、ライブ ブロードキャストを viewCount で並べ替えると、ブロードキャストの継続中に API の結果がブロードキャストの同時視聴者数で並べ替えられることに注意されました。

    • search.list メソッドの relatedToVideoId パラメータが更新され、このパラメータが設定されている場合、サポートされている他のパラメータは、partmaxResultspageTokenregionCoderelevanceLanguagesafeSearchtypevideo に設定する必要があります)、fields のみであることを明記しました。今回の更新は、API の動作の変更を反映するものではありません。

    • video リソースの snippet.publishedAt プロパティの定義を更新し、プロパティ値(動画の公開日時を指定する)が動画がアップロードされた日時と異なる可能性があることを指摘しました。たとえば、動画を非公開動画としてアップロードし、後で公開にした場合、このプロパティ値は、動画が公開された時刻を示します。更新された定義では、非公開動画と限定公開の動画に関する値の入力方法も説明されています。

      この変更は API の動作の変更を反映するものではありません。

    • video リソースの status.publishAt プロパティの定義が更新され、次の点に注意してください。

      • videos.update メソッドを呼び出すときにこのプロパティの値を設定する場合は、動画がすでに非公開であっても、status.privacyStatus プロパティの値を private に設定する必要があります。
      • 過去のある時点に動画を公開するようにリクエストした場合、動画はすぐに公開されます。そのため、status.publishAt プロパティに過去の日時を設定した場合は、動画の privacyStatusprivate から public に変更した場合と同じことになります。
    • video リソースの contentDetails.contentRating.cncRating プロパティには、フランスの委員会による映画監督による動画のレーティングを指定します。このプロパティは、非推奨になった contentDetails.contentRating.fmocRating プロパティに代わるものです。

    • channel リソースの brandingSettings.channel.keywords の定義が更新され、以前ドキュメント化されたとおり、プロパティ値にカンマ区切りのリストではなくスペース区切りのリストが含まれることが正しく反映されました。今回の更新は、API の動作の変更を反映するものではありません。

    • アップロードして動画に関連付けるサムネイル画像がリクエストの本文に含まれていることが正確に反映されるよう、thumbnails.set メソッドのドキュメントが更新されました。リクエストの本文に thumbnail リソースが含まれていません。以前のドキュメントでは、このメソッドを呼び出すときはリクエスト本文を指定すべきではないと記載されていました。今回の更新は、API の動作の変更を反映するものではありません。

    • 現在、activities.list メソッドに新しい動画のコメントに関連するリソースが含まれていないことを反映して、activity リソースの説明を更新しました。リソースの snippet.typecontentDetails.comment も更新されました。

  • 新しいエラーと更新エラー

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

      エラーの詳細
      activities.insert
      HTTP レスポンス コードbadRequest (400)
      理由invalidMetadata
      説明kind プロパティが、指定された ID のタイプと一致しません。
      commentThreads.update
      comments.insert
      comments.update
      HTTP レスポンス コードbadRequest (400)
      理由commentTextTooLong
      説明挿入または更新対象の comment リソースの snippet.topLevelComment.snippet.textOriginal プロパティに含まれる文字数が多すぎます。
      playlistItems.insert
      playlistItems.update
      HTTP レスポンス コードforbidden (403)
      理由playlistItemsNotAccessible
      説明リクエストは、指定された再生リスト アイテムを挿入、更新、削除するための適切な承認を得ていません。
      playlists.delete
      playlists.insert
      playlists.update
      HTTP レスポンス コードbadRequest (400)
      理由playlistForbidden
      説明この操作は禁止されているか、リクエストが適切に認証されていません。
      search.list
      HTTP レスポンス コードbadRequest (400)
      理由invalidLocation
      説明location または locationRadius(あるいはその両方)のパラメータ値の形式が正しくありません。
      search.list
      HTTP レスポンス コードbadRequest (400)
      理由invalidRelevanceLanguage
      説明relevanceLanguage パラメータ値の形式が正しくありません。
      subscriptions.insert
      HTTP レスポンス コードbadRequest (400)
      理由subscriptionForbidden
      説明このエラーは、次のいずれかに該当する場合に発生します。
      • 作成しようとしているサブスクリプションはすでに存在しています
      • サブスクリプションの数がすでに上限に達しています
      • ご自身のチャンネルを登録しようとしていますが、これはサポートされていません。
      • 最近作成したサブスクリプションの数が多すぎるため、数時間待ってからリクエストを再試行してください。
      videos.update
      HTTP レスポンス コードbadRequest (400)
      理由invalidDefaultBroadcastPrivacySetting
      説明リクエストは、デフォルトのブロードキャストに無効なプライバシー設定を指定しようとしています。

2015 年 8 月 28 日

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

  • 既存のリソースとメソッドの更新

    • video リソースの statistics.favoriteCount プロパティが非推奨になりました。

      Google のサポート終了ポリシーに従い、このプロパティは、この発表から少なくとも 1 年間は video リソースに引き続き含まれます。ただし、プロパティ値は常に 0 に設定されるようになりました。

2015 年 8 月 7 日

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

  • 既存のリソースとメソッドの更新

    • video リソースの snippet.tags[] プロパティの定義が更新され、API サーバーがプロパティの値の長さを計算する方法に関する詳細情報が提供されます。なお、今回の更新は API の動作の変更を反映するものではありません。

      具体的には、タグにスペースが含まれている場合、API サーバーはタグ値が引用符で囲まれている場合と同様に処理され、引用符が文字数制限にカウントされることが定義に示されています。したがって、文字数制限のため、タグ Foo-Baz には 7 文字が含まれていますが、タグ Foo Baz には 9 文字が含まれています。

    • commentThreads.insert メソッドで shareOnGooglePlus パラメータがサポートされなくなりました。以前は、コメントとそのコメントへの返信も投稿者の Google+ プロフィールに投稿する必要があるかどうかを指定していました。リクエストでパラメータが送信されると、API サーバーではパラメータは無視されますが、それ以外の場合はリクエストを処理します。

2015 年 6 月 18 日

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

  • 既存のリソースとメソッドの更新

    • commentThreads.list メソッドの新しい order パラメータには、API レスポンスがコメント スレッドをリストする順序を指定します。スレッドは時間または関連性で並べ替えることができます。デフォルトの動作では、時系列順に並べられます。

    • video リソースの新しい snippet.defaultAudioLanguage プロパティには、動画のデフォルトの音声トラックで話されている言語を指定します。

    • video リソースの contentDetails.licensedContent プロパティの定義を更新し、コンテンツが YouTube コンテンツ パートナーにリンクされているチャンネルにアップロードされ、その後そのパートナーによって申し立てが行われている必要があることを明確にしました。これは実際の API の動作を変更するものではありません。

    • captions.deletecaptions.downloadcaptions.insertcaptions.listcaptions.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 Cloud Console でデベロッパーのアプリケーションに関連付けられているプロジェクト番号が自動的にタグ付けされます。

      その後、検索リクエストで forDeveloper パラメータが true に設定されると、API サーバーはリクエストの認証情報を使用してデベロッパーを識別します。そのため、デベロッパーは、検索結果をデベロッパー自身のアプリやウェブサイト経由でアップロードした動画に制限できます。他のアプリやサイト経由でアップロードした動画に制限することはできません。

      この新機能は、v2 API でサポートされていたデベロッパー タグ機能と同一ではないものの、同様の機能を提供します。

    • channel リソースの新しい snippet.country プロパティを使用すると、チャンネル所有者はチャンネルを特定の国に関連付けることができます。

      注: channel リソースの snippet.country プロパティを設定するには、実際には brandingSettings.channel.country プロパティを更新する必要があります。

    • API が channelSection リソースのターゲティングをサポートするようになりました。チャンネル セクションのターゲティングを使用すると、特定の条件に一致するユーザーにコンテンツ セクションの公開を制限することができます。

      API では、3 つのターゲティング オプションを利用できます。ユーザーがチャンネル セクションを表示するには、すべてのターゲット設定を満たしている必要があります。

    • video リソースの contentDetails.duration プロパティの定義が修正されました。この値は、時間、日などを反映できることを反映しています。

    • channelSections.deleteplaylistItems.deleteplaylists.deletesubscriptions.deletevideos.delete メソッドのドキュメントを更新し、これらのメソッドが成功すると HTTP 204 レスポンス コード(No Content)を返すことを反映しました。

  • 新しいエラーと更新エラー

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

      エラーのタイプ エラーの詳細 説明
      badRequest (400) targetInvalidCountry channelSections.insert メソッドと channelSections.update メソッドは、挿入された channelSection リソースに targeting.countries[] プロパティに無効な値が含まれている場合、このエラーを返します。
      badRequest (400) targetInvalidLanguage channelSections.insert メソッドと channelSections.update メソッドは、挿入された channelSection リソースに targeting.languages[] プロパティに無効な値が含まれている場合、このエラーを返します。
      badRequest (400) targetInvalidRegion channelSections.insert メソッドと channelSections.update メソッドは、挿入された channelSection リソースに targeting.regions[] プロパティに無効な値が含まれている場合、このエラーを返します。
      badRequest (400) operationNotSupported API ユーザーが snippet.parentId プロパティで指定されたトップレベル コメントに対してコメントを挿入できない場合、comments.insert メソッドはこのエラーを返します。commentThread リソースでは、snippet.canReply プロパティは現在の閲覧者がスレッドに返信できるかどうかを示します。
      badRequest (400) invalidChannelId search.list メソッドは、リクエストの channelId パラメータに無効なチャンネル ID が指定された場合、このエラーを返します。
      badRequest (400) subscriptionForbidden API ユーザーがユーザー自身のチャンネルに登録しようとすると、subscriptions.insert メソッドはこのエラーを返します。
    • captions.update メソッドが invalidMetadata エラーと videoNotFound エラーをサポートしなくなりました。

2015 年 4 月 16 日

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

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

    このガイドでは、v2 API ではサポートされていなかったが v3 API ではサポートされているコメント機能についてもいくつか言及しています。たとえば

    • チャンネルに関するコメントを取得する
    • チャンネルに関連するすべてのコメント スレッドを取得する。つまり、API レスポンスにはチャンネルやその動画に関するコメントが含まれる可能性がある。
    • コメントのテキストの更新
    • コメントをスパムとしてマークする
    • コメントの管理ステータスを設定する

  • プッシュ通知の登録ガイドを更新し、以前にお知らせしたとおり、通知は Google PubSubHubBub ハブにのみプッシュされ、Superfeedr ハブにはプッシュされないという事実を反映しました。

2015 年 4 月 9 日

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

  • API の新しい commentThread リソースと comment リソースを使用すると、コメントの取得、挿入、更新、削除、管理を行うことができます。

    • commentThread リソースには、YouTube のコメント スレッドに関する情報が含まれています。コメント スレッドは、最上位のコメントと、そのコメントに対する返信(存在する場合)で構成されます。commentThread リソースは、動画またはチャンネルのいずれかについてのコメントを表します。

      最上位のコメントと返信は、実際には commentThread リソース内にネストされた comment リソースです。commentThread リソースには、必ずしもコメントに対するすべての返信が含まれているわけではありません。特定のコメントに対するすべての返信を取得するには、comments.list メソッドを使用する必要があります。また、一部のコメントには返信がありません。

      この API では、commentThread リソースについて次のメソッドがサポートされています。

      • commentThreads.list – コメント スレッドのリストを取得します。特定の動画またはチャンネルに関連付けられているコメントを取得するには、このメソッドを使用します。
      • commentThreads.insert – 新しい最上位のコメントを作成します。(既存のコメントに返信するには、comments.insert メソッドを使用します)。
      • commentThreads.update – 最上位のコメントを変更します。

    • comment リソースには、1 つの YouTube コメントに関する情報が含まれます。comment リソースは、動画またはチャンネルに関するコメントを表します。また、トップレベル コメントまたはトップレベル コメントに対する返信をコメントにすることができます。

      この API では、comment リソースについて次のメソッドがサポートされています。

      • comments.list – コメントのリストを取得します。特定のコメントに対するすべての返信を取得するには、このメソッドを使用します。
      • comments.insert – 既存のコメントへの返信を作成します。
      • comments.update – コメントを変更します。
      • comments.markAsSpam – 1 つ以上のコメントをスパムとして報告します。
      • comments.setModerationStatus – 1 つ以上のコメントの管理ステータスを設定します。たとえば、コメントをクリアして一般公開したり、表示に適さないコメントとしてコメントを拒否したりできます。API リクエストは、コメントに関連付けられたチャンネルまたは動画の所有者によって承認される必要があります。
      • comments.delete – コメントを削除します。

    なお、comments.insertcomments.updatecomments.markAsSpamcomments.setModerationStatuscomments.deletecommentThreads.insertcommentThreads.update の各メソッドを呼び出すには、API の新しい https://www.googleapis.com/auth/youtube.force-ssl スコープ(2015 年 4 月 2 日の変更履歴に記載)が必要です。

  • 新しいプッシュ通知の登録ガイドでは、PubSubHubBub(ウェブアクセス可能なリソースのためのサーバー間パブリッシュ/サブスクライブ プロトコル)を介したプッシュ通知の API の新しいサポートについて説明しています。PubSubHubBub コールバック サーバーは、チャンネルが次のいずれかのアクティビティを行ったときに、Atom フィード通知を受け取ることができます。

    • 動画をアップロードした
    • 動画のタイトルを更新する
    • 動画の説明を更新したとき

  • 移行ガイドも更新され、プッシュ通知の新しいサポートに関する説明が追加されました。ただし、v2 API は v3 API ではサポートされていない他の種類のプッシュ通知もサポートしていたため、PubSubHubBub のサポートについては、このガイドの非推奨セクションに引き続き記載されています。

  • API の新しい https://www.googleapis.com/auth/youtube.force-ssl スコープが、これまで https://www.googleapis.com/auth/youtube スコープをサポートしていたすべての API メソッドで有効なスコープになりました。

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

    エラーのタイプ エラーの詳細 説明
    badRequest (400) invalidRating videos.rate メソッドは、リクエストの rating パラメータに予期しない値が含まれていた場合に、このエラーを返します。
  • subscriptions.insert メソッドで subscriptionLimitExceeded エラーがサポートされなくなりました。以前は、リクエストで特定されたサブスクライバーがサブスクリプションのレート制限を超えていることが示されていました。

2015 年 4 月 2 日

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

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

    この API では、字幕トラックの一覧表示挿入更新ダウンロード削除の各メソッドがサポートされています。

  • 移行ガイドも更新され、v2 API の字幕機能をまだ使用しているアプリケーションを移行する方法について説明しています。

  • API の新しい https://www.googleapis.com/auth/youtube.force-ssl スコープでは、API サーバーとの通信が SSL 接続を介して行われる必要があります。

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

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

2015 年 3 月 11 日

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

  • YouTube Data API(v3)移行ガイドには、[v3 API の新機能] という新しいタブがあり、v3 API でサポートされている機能と v2 API でサポートされていない機能がリストされています。ガイドの他のタブでは、以前と同じ機能をご利用いただけます。たとえば、チャンネルの動画内プロモーション キャンペーン データの更新方法を説明する新機能は、[チャンネル(プロフィール)] タブにも表示されます。

  • YouTube Data API(v3)移行ガイドを更新し、v3 API が次の v2 API 機能をサポートすることを記載しました。

  • YouTube Data API(v3)移行ガイドが更新され、次の v2 API 機能は v3 API でサポートされなくなることを記載しました。

    • おすすめの動画を取得する – v3 API は、現在の API ユーザーにおすすめの動画のみを含むリストは取得しません。ただし、v3 API を使用しておすすめ動画を検索するには、activities.list メソッドを呼び出し、home パラメータ値を true に設定します。

      API レスポンスでは、snippet.type プロパティの値が recommendation の場合、リソースはおすすめの動画に対応します。その場合、contentDetails.recommendation.reason プロパティと contentDetails.recommendation.seedResourceId プロパティには、動画がおすすめされた理由に関する情報が含まれます。レスポンスに、特定の数のおすすめ動画が含まれているとは限りません。

    • おすすめのチャンネルを取得する

    • 新しい登録チャンネルの動画を取得する – v3 API では、API ユーザーが登録しているチャンネルに最近アップロードされた動画のみを含むリストは取得されません。ただし、v3 API を使用して新しい定期購入動画を探すには、activities.list メソッドを呼び出して home パラメータ値を true に設定します。

      API レスポンスでは、snippet.type プロパティの値が upload の場合、リソースは新しい定期購入動画に対応します。レスポンスに、特定の数の新しいチャンネル登録動画が含まれているという保証はありません。

    • RSS フィードのサポート

    • フィード更新のプッシュ通知 – v2 API は YouTube ユーザーのアクティビティ フィードをモニタリングするために、シンプル アップデート プロトコル(SUP)または PubSubHubbub を使用するプッシュ通知をサポートしていました。新規チャンネル登録、動画の評価、共有、お気に入り登録、コメントの投稿、アップロードの際に通知が送信されました。

      v3 API では、PubSubHubbub プロトコルを使用したプッシュ通知がサポートされていますが、通知は動画のアップロードと、動画のタイトルまたは動画の説明の更新のみを対象としています。

    • チャンネルの場所 – v2 API では、チャンネルの YouTube 公開プロフィールに入力されたユーザーの場所を <yt:location> タグを使用して識別しました。一部のデベロッパーはこのフィールドを使用してチャネルを特定の国に関連付けることができましたが、その目的でフィールドのデータを一貫して使用することができませんでした。

    • デベロッパー タグの設定または取得 – v2 API では、動画のアップロード時にキーワード(デベロッパー タグ)を動画に関連付ける機能がサポートされていました。デベロッパー タグは YouTube ユーザーには表示されませんが、動画の所有者は特定のデベロッパー タグに一致する動画を取得できます。

      V3 API でも同様の機能を提供しますが、同一ではありません。具体的には、デベロッパー自身のアプリケーションによってアップロードされた動画を検索できます。この機能では、アップロードされた各動画に、Google Cloud Console でデベロッパーのアプリケーションに関連付けられているプロジェクト番号が自動的にタグ付けされます。その後、同じプロジェクト番号を使用して動画を検索します。

    • 公開日、視聴回数、評価で動画を一覧表示する – v2 API では、orderby パラメータを使用して、位置、再生時間、公開日、タイトルなどの値で再生リスト内の動画を並べ替えることができます。v3 API では、再生リストのアイテムは通常、位置によって昇順で並べ替えられますが、他の並べ替えオプションは使用できません。

      ただし、次のような例外があります。以下の種類の再生リストでは、新しいアップロード動画、お気に入りの動画、高く評価した動画、最近再生した動画が最初の項目として自動的に追加されます(snippet.position=0)。したがって、これらの各リストは、アイテムがリストに追加された時間に基づいて、新しいアイテムから古いアイテムの順に効率的に並べ替えられます。

      • ユーザーによるアップロード
      • お気に入りの動画
      • 高く評価した動画
      • 再生履歴

      ただし、[後で見る] 再生リストに追加された新しいアイテムは、そのリストの最後のアイテムとして追加されるため、リストは実質的に古い順に並べられます。

    • バッチ処理 – v3 API は、v2 API がサポートしていたバッチ処理のユースケースのいずれかに対応しています。v3 API の channels.listchannelSections.listguideCategories.listplaylistItems.listplaylists.listsubscriptions.listvideoCategories.listvideos.list のメソッドはすべて id パラメータをサポートしています。このパラメータを使用すると、ID(動画 ID、チャンネル ID など)のカンマ区切りリストを指定できます。これらのメソッドを使用すると、1 回のリクエストで複数のリソースのリストを取得できます。

    この変更に伴い、このガイドでは、古い(v2)API でサポートされていた機能のうち、現在の API バージョン(v3)でサポートが終了するすべての機能を確認するようになりました。

2015 年 3 月 4 日

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

  • channelSections.delete メソッドと channelSections.update メソッドが onBehalfOfContentOwner パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。

  • 次のプロパティとその子プロパティは非推奨になりました。

    • brandingSettings.image.backgroundImageUrl
    • brandingSettings.image.largeBrandedBannerImageImapScript
    • brandingSettings.image.largeBrandedBannerImageUrl
    • brandingSettings.image.smallBrandedBannerImageImapScript
    • brandingSettings.image.smallBrandedBannerImageUrl

    注: これらのプロパティはいずれも API サポート終了ポリシーの対象ではありませんでした。

  • video リソースの新しい contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons プロパティは、動画が DJCQT(ブラジル)レーティングを受けた理由を説明するものです。

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

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

2015 年 3 月 2 日

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

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

    YouTube Data API(v3)移行ガイドも更新され、この新しいパラメータの使用方法が説明されています。このパラメータは、現在の API バージョン(v3)と、すでに非推奨となっている以前のバージョン(v2)との間に存在していた機能のギャップに対処します。

  • YouTube Data API(v3)移行ガイドも更新され、映画、予告編、テレビ番組、テレビ番組のシーズン、テレビ番組のエピソードを記述するために v2 API で提供されていた特別なフィードとメタデータ フィールドが廃止されました。

2015 年 1 月 14 日

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

  • YouTube Data API(v3)移行ガイドを更新し、v3 API を使用して JavaScript で動画をアップロードする方法について説明しました。(詳しくは、動画をアップロードするをご覧ください)。この機能は、v2 API がサポートするブラウザベースのアップロード機能に匹敵します。なお、この移行ガイドの変更は、実際の API の変更を反映するものではありませんが、クライアントサイドの JavaScript を使用して動画をアップロードするための新しいサンプルコードが利用可能になったことを反映しています。

    JavaScript クライアント ライブラリと CORS を使用した動画のアップロードがサポートされているため、移行ガイドでは、v3 API でサポートが終了する可能性のある機能としてブラウザベースのアップロードについて記載することはなくなりました。

  • videos.insert メソッドのドキュメントが更新され、上記の新しい JavaScript コードサンプルが含まれるようになりました。YouTube Data API(v3)の JavaScript のコードサンプルも更新されました。

2014 年 11 月 11 日

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

  • search.list メソッドの呼び出しの割り当て費用が 100 ユニットに変更されました。

    重要: 多くの場合、他の API メソッドを使用して、より低い割り当てコストで情報を取得できます。たとえば、GoogleDevelopers チャンネルにアップロードされた動画を探すには、次の 2 つの方法があります。

    • 割り当ての費用: 100 ユニット

      search.list メソッドを呼び出して、GoogleDevelopers を検索します。

    • 割り当ての費用: 6 ユニット

      channels.list メソッドを呼び出して、正しいチャンネル ID を確認します。forUsername パラメータを GoogleDevelopers に、part パラメータを contentDetails に設定します。API レスポンスでは、contentDetails.relatedPlaylists.uploads プロパティに、チャンネルにアップロードされた動画の再生リスト ID を指定します。

      次に、playlistItems.list メソッドを呼び出し、playlistId パラメータをキャプチャ ID に設定し、part パラメータを snippet に設定します。

2014 年 10 月 8 日

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

  • channel リソースに、次の 2 つの新しいプロパティが追加されました。

    • status.longUploadsStatus プロパティは、チャンネルが 15 分を超える動画をアップロードできるかどうかを示します。このプロパティは、チャンネル所有者が API リクエストを承認した場合にのみ返されます。有効な値は次のとおりです。

      • allowed – このチャンネルは 15 分を超える動画をアップロードできます。
      • eligible – このチャンネルは 15 分を超える動画をアップロードできますが、最初にこの機能を有効にする必要があります。
      • disallowed – このチャンネルは 15 分を超える動画をアップロードできない、またはアップロードできません。

      これらの値の詳細については、プロパティの定義を参照してください。YouTube ヘルプセンターでも、この機能について詳しく説明しています。

    • invideoPromotion.useSmartTiming プロパティは、チャンネルのプロモーション キャンペーンで「スマート タイミング」が使用されているかどうかを示します。この機能は、動画内の、クリックされる可能性が高く、視聴の妨げとなりにくいタイミングでプロモーションを表示することを目的としています。また、動画ごとにプロモーションを 1 つ選択して表示します。

  • video リソースの snippet.title プロパティと snippet.categoryId プロパティの定義を更新し、API が videos.update メソッドの呼び出しを処理する方法を明確にしました。そのメソッドを呼び出して video リソースの snippet 部分を更新する場合は、両方のプロパティに値を設定する必要があります。

    video リソースの snippet 部分を更新しようとする際に、これらのプロパティの両方に値を設定しないと、API から invalidRequest エラーが返されます。エラーの説明も更新されました。

  • video リソースの contentDetails.contentRating.oflcRating プロパティは、ニュージーランドのフィルム・文学分類局による動画のレーティングを識別するもので、oflcRp13oflcRp16 という 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 つの部分(snippetcontentDetailssubscriberSnippet)で構成され、各部分の費用は 2 ユニットです。

    割り当てコストは、警告なしに変更されることがあります。

  • video リソースは、43 の新しいコンテンツ レーティング システムをサポートするようになりました。このシステムは、動画がさまざまな国家レーティング機関から受けたレーティングを識別します。新たにサポートされるレーティング システムは、アルゼンチンオーストリアベルギー、2、ブルガリア、チリ(television)、チリ(映画)、チェココロンビアデンマークエジプト 2

2014 年 5 月 28 日

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

  • search.list メソッドが location パラメータと locationRadius パラメータをサポートするようになりました。これにより、地理的位置に関連付けられた動画を検索できるようになります。位置情報に基づいて結果を取得するには、リクエストで両方のパラメータの値を指定する必要があります。2 つのパラメータのいずれか一方のみがリクエストに含まれている場合、API はエラーを返します。

    • location パラメータは、円形の地理的領域の中心の緯度と経度の座標を指定します。

    • locationRadius パラメータでは、動画に関連付けられた場所が領域の中心からどのくらい離れても、動画が検索結果に表示される場合の、最大距離を指定します。

2014 年 5 月 13 日

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

  • channel リソースの invideoPromotion.items[] プロパティが更新され、通常、チャンネルに対して設定できるプロモート アイテムは 1 つのみであることが示されました。挿入しようとするプロモート アイテムが多すぎると、API は tooManyPromotedItems エラー(HTTP 400 ステータス コード)を返します。

  • channelSection リソースで、新しいタイプの注目コンテンツに関する情報を追加できるようになりました。channelSection リソースの snippet.type プロパティで次の値がサポートされるようになりました。

    • postedPlaylists - チャンネルの所有者がチャンネルのアクティビティ フィードに投稿した再生リスト
    • postedVideos - チャンネルの所有者がチャンネルのアクティビティ フィードに投稿した動画
    • subscriptions - チャンネル所有者が登録しているチャンネル

  • video リソースの新しい contentDetails.contentRating.ifcoRating プロパティは、アイルランド映画分類局から動画が受けたレーティングを識別します。

  • watermark リソースの position.cornerPosition プロパティの定義を更新し、透かしがプレーヤーの右上に常に表示されるようになりました。

  • search.list メソッドの q パラメータの定義を更新し、クエリ語句でブール演算子の NOT(-)演算子を使用して特定の検索語句に関連する動画を除外できることを記載しました。値にブール演算子 OR(|)演算子を使用して、複数の検索キーワードのいずれかに関連する動画を探すこともできます。

  • search.list 呼び出しに対する API レスポンスで返される pageInfo.totalResults プロパティの定義を更新し、値は近似値であり、正確な値ではない可能性があることを追加しました。また、最大値は 1,000,000 です。この値を使用してページ間のリンクを作成しないでください。代わりに、nextPageToken プロパティ値と prevPageToken プロパティ値を使用して、ページ リンクを表示するかどうかを決定します。

  • watermarks.set メソッドと watermarks.unset メソッドが更新され、これらのメソッドへのリクエストに成功すると API が HTTP 204 レスポンス コードを返すようになりました。

2014 年 5 月 2 日

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

  • 新しい i18nLanguage リソースは、YouTube ウェブサイトがサポートするアプリケーション言語を識別します。アプリ言語は UI 言語と呼ばれることもあります。YouTube ウェブサイトの場合、Google アカウントの設定、ブラウザの言語、IP の場所に基づいてアプリケーションの言語を自動的に選択したり、ユーザーが YouTube サイトのフッターから必要な UI の言語を手動で選択したりすることもできます。

    API は、サポートされているアプリケーション言語を一覧表示するメソッドをサポートしています。サポートされている言語は、videoCategories.listguideCategories.list などの API メソッドを呼び出すときに、hl パラメータの値として使用できます。

  • 新しい i18nRegion リソースは、YouTube ユーザーが優先コンテンツの地域として選択できる地域を識別します。コンテンツ ロケールは、コンテンツ ロケールとも呼ばれます。YouTube ウェブサイトの場合、コンテンツの地域は YouTube ドメインやユーザーの IP の場所などのヒューリスティックに基づいて自動的に選択されます。また、ユーザーは YouTube サイトのフッターから目的のコンテンツの地域を手動で選択することもできます。

    この API では、サポートされているコンテンツ リージョンを一覧表示するメソッドがサポートされています。サポートされている地域コードは、search.listvideos.listactivities.listvideoCategories.list などの API メソッドを呼び出すときに regionCode パラメータの値として使用できます。

2014 年 4 月 7 日

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

  • 新しい channelSection リソースには、チャンネルがおすすめとして取り上げた動画セットに関する情報が含まれています。たとえば、チャンネルの最新アップロード、特に人気の高いアップロード、1 つまたは複数の再生リストの動画などを 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 日

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

2014 年 3 月 13 日

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

  • API が channel リソースの contentOwnerDetails 部分をサポートするようになりました。新しい部分には、チャンネルにリンクされている YouTube パートナーに関連するチャンネル データ(チャンネルにリンクされているコンテンツ所有者の ID、コンテンツ所有者とチャンネルがリンクされた日時など)が含まれます。この新しい部分は非推奨ポリシーの対象ではありません

  • ドキュメントでは、次のプロパティについてサポートされている最大文字数がリストされるようになりました。

    リソース プロパティ 最大文字数
    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 channels.update メソッドは、invideoPromotion.items[].id.videoId プロパティに指定されている動画 ID が見つからないか、プロモート アイテムとして使用できない場合に、このエラーを返します。
    forbidden (403) websiteLinkNotAllowed channels.update メソッドは、許可されていない URL が invideoPromotion.items[].id.websiteUrl プロパティで指定されている場合、このエラーを返します。
    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 日

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

2013 年 12 月 5 日

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

  • search.list メソッドのドキュメントを更新し、検索リクエストを送信するときに 1 つのフィルタ パラメータの値を指定する必要はないことを適切に反映しました。代わりに、ゼロのフィルターパラメーターまたは 1 つのフィルターパラメーターに値を設定できます。

  • 次のいずれかのパラメータの値も指定する場合、type パラメータの値を video に設定する必要があることを示すため、search.list メソッドのパラメータの定義を更新しました。

    • eventType
    • videoCaption
    • videoCategoryId
    • videoDefinition
    • videoDimension
    • videoDuration
    • videoEmbeddable
    • videoLicense
    • videoSyndicated
    • videoType

  • アップロードされるチャンネル バナー画像の最小サイズが 2,048 x 1,152 ピクセルに縮小されました。(以前の最小サイズは 2,120 x 1,192 ピクセルでした)。また、channel リソースのドキュメントには、API から配信されるすべてのバナー画像の最大サイズが規定されています。たとえば、テレビ向けアプリの場合、brandingSettings.image.bannerTvImageUrl の画像の最大サイズは 2120x1192 ピクセルですが、実際の画像は 2048x1152 ピクセルになることがあります。YouTube ヘルプセンターでは、各種デバイスで表示するためにチャンネル アートを最適化するための詳しいガイダンスを紹介しています。

  • いくつかの channel リソース プロパティの定義が更新され、次の情報が反映されました。

    • brandingSettings.channel.description プロパティの値の最大長は 1,000 文字です。
    • brandingSettings.channel.featuredChannelsTitle プロパティの最大長は 30 文字です。
    • brandingSettings.channel.featuredChannelsUrls[] プロパティに最大 100 個のチャネルをリストできるようになりました。
    • brandingSettings.channel.unsubscribedTrailer プロパティ値が設定されている場合は、チャンネル所有者が所有する公開動画の YouTube 動画 ID を指定する必要があります。

  • channels.update メソッドが invideoPromotion.items[].promotedByContentOwner プロパティの更新をサポートするようになりました。このプロパティは、プロモーションの表示時にコンテンツ所有者の名前を表示するかどうかを示します。このプロパティを設定できるのは、プロパティ値を設定する API リクエストが、onBehalfOfContentOwner パラメータを使用してコンテンツ所有者の代わりに行われている場合に限られます。

  • playlistItems.list メソッドと playlistItems.insert メソッドが onBehalfOfContentOwner パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。

  • contentDetails.contentRating.acbRating プロパティを使用して、映画の場合は Australian Classification Board(ACB)のレーティング、子ども向けテレビ番組の場合は Australia Communications and Media Authority(ACMA)のレーティングを指定できるようになりました。

  • 新しい contentDetails.contentRating.catvRating プロパティと contentDetails.contentRating.catvfrRating プロパティは、カナダのテレビ分類システムとケベック州で使用されるフランス語の Régie du cinéma レーティング システムに基づいて動画が受けたレーティングを識別します。

  • videoCategory リソースの新しい snippet.assignable プロパティは、更新された動画または新しくアップロードされた動画をその動画カテゴリに関連付けることができるかどうかを示します。

  • 次のメソッドのコードサンプルが追加されました。

2013 年 10 月 24 日

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

  • この API には、ライブ配信コンテンツの検索と表示に役立つ機能が 2 つ追加されています。

    検索結果の新しい snippet.liveBroadcastContent プロパティは、動画リソースまたはチャンネル リソースにライブ配信コンテンツが含まれているかどうかを示します。有効な値は upcomingactivenone です。

    • video リソースの新しい snippet.liveBroadcastContent プロパティは、動画が今後配信中か、実施中のライブ配信かを示します。このプロパティで使用できる値は次のとおりです。

      • upcoming – まだ開始されていないライブ配信の動画です。
      • active – 動画は進行中のライブ配信です。
      • none – この動画は近日公開予定の、または現在実施中のライブ配信ではありません。これは、YouTube で引き続き視聴可能な、完了したブロードキャストのプロパティ値です。

    • video リソースの新しい liveStreamingDetails プロパティは、ライブ動画ブロードキャストに関するメタデータを含むオブジェクトです。このメタデータを取得するには、part パラメータ値のリソース パーツのリストに liveStreamingDetails を含めます。メタデータには次の新しいプロパティが含まれています。

      このメタデータを取得するには、videos.listvideos.insert、または videos.update メソッドを呼び出すときに、part パラメータ値に liveStreamingDetails を含めます。

    ライブ配信コンテンツを識別するための他の 2 つの機能が、2013 年 10 月 1 日にリリースされました。search.list メソッドの eventType パラメータと検索結果の snippet.liveBroadcastContent プロパティです。

  • videos.insert メソッドが notifySubscribers パラメータをサポートするようになりました。このパラメータは、動画のチャンネルに登録するユーザーに新しい動画に関する通知を送信するかどうかを示すものです。このパラメータのデフォルト値は True で、新しくアップロードされた動画がチャンネル登録者に通知されることを示します。ただし、多数の動画をアップロードしているチャンネル所有者は、値を False に設定して、新しい動画に関する通知がチャンネル登録者に送信されないようにすることをおすすめします。

  • channels.update メソッドを呼び出すときに変更できるプロパティのリストが更新され、invideoPromotion.items[].customMessage プロパティと invideoPromotion.items[].websiteUrl プロパティが含まれるようになりました。また、変更可能な brandingSettings プロパティを識別するようにリストが変更されました。これらの brandingSettings プロパティはすでに変更可能であるため、ドキュメントの変更には API の既存の機能の変更が反映されていません。

  • playlists.insertplaylists.updateplaylists.delete の各メソッドが onBehalfOfContentOwner パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。

  • playlists.insert メソッドが onBehalfOfContentOwnerChannel パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。

  • video リソースの contentDetails.contentRating.tvpgRating プロパティで、TV-14 の評価に対応する pg14 の値がサポートされるようになりました。

  • 検索結果の一部である snippet.liveBroadcastContent プロパティの定義を修正しました。live は有効なプロパティ値であるが active は有効なプロパティ値ではないことが反映されるよう修正されました。

  • video リソースの contentDetails.contentRating.mibacRating プロパティが、次の 2 つの追加評価をサポートするようになりました。

    • mibacVap(VAP)– お子様は大人の同伴が必要です。
    • mibacVm6(V.M.6)- 6 歳以上に制限されます。
    • mibacVm12(V.M.12)– 12 歳以上に制限されます。

  • channel リソースの新しい invideoPromotion.items[].promotedByContentOwner プロパティは、プロモーションの表示時にコンテンツ所有者の名前を表示するかどうかを示します。このフィールドを設定できるのは、値を設定する API リクエストがコンテンツ所有者に代わって行われている場合のみです。詳細については、onBehalfOfContentOwner パラメータをご覧ください。

2013 年 10 月 1 日

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

  • channel リソースの新しい auditDetails オブジェクトには、マルチチャンネル ネットワーク(MCN)が特定のチャンネルを承認するかどうかを判断する際に評価するチャンネル データが含まれています。このリソース部分を取得する API リクエストは、https://www.googleapis.com/auth/youtubepartner-channel-audit スコープを含む認証トークンを提供する必要があります。また、MCN がチャンネルを承認または拒否した場合、またはトークン発行日から 2 週間以内に、そのスコープを使用するトークンを取り消す必要があります。

  • channel リソースの invideoPromotion.items[].id.type プロパティで値 recentUpload がサポートされるようになりました。これは、プロモートされたアイテムが、指定されたチャンネルから最近アップロードされた動画であることを示します。

    デフォルトでは、チャンネルは動画内プロモーション データが設定されているチャンネルと同じになります。ただし、新しい invideoPromotion.items[].id.recentlyUploadedBy プロパティの値をそのチャンネルのチャンネル ID に設定することで、別のチャンネルから最近アップロードされた動画をプロモートできます。

  • channel リソースには、brandingSettings.image.bannerTvLowImageUrlbrandingSettings.image.bannerTvMediumImageUrlbrandingSettings.image.bannerTvHighImageUrl の 3 つの新しいプロパティが含まれています。このプロパティは、テレビアプリのチャンネル ページに表示されるバナー画像の URL を指定します。

  • 検索結果の新しい snippet.liveBroadcastContent プロパティは、動画リソースまたはチャンネル リソースにライブ配信コンテンツが含まれているかどうかを示します。有効な値は upcomingactivenone です。

    • video リソースの場合、値 upcoming は動画がまだ開始されていないライブ配信であることを示し、値 active は動画が進行中のライブ配信であることを示します。
    • channel リソースの場合、値 upcoming はチャンネルにまだ開始されていないスケジュール設定されたブロードキャストがあることを示し、値 acive はチャンネルで進行中のライブ配信があることを示します。

  • watermark リソースで、targetChannelId プロパティがオブジェクトから文字列に変更されました。透かし画像がリンクしているチャンネルの YouTube チャンネル ID を指定する子プロパティを格納する代わりに、targetChannelId プロパティにその値自体を指定するようになりました。そのため、リソースの targetChannelId.value プロパティが削除されました。

  • thumbnails.set メソッドが onBehalfOfContentOwner パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。

  • search.list メソッドが eventType パラメータをサポートするようになりました。これにより、有効なブロードキャスト イベント、今後のブロードキャスト イベント、または完了したブロードキャスト イベントのみを返すように検索を制限できます。

  • 新しい contentDetails.contentRating.mibacRating プロパティは、イタリアの Ministero dei Beni e delle Attivita Culturali e del Turismo から動画に対して付けられた評価を識別します。

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

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

2013 年 8 月 27 日

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

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

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

    エラー ドキュメントには、特に watermarks.set メソッドと watermarks.unset メソッド向けに API がサポートするエラー メッセージが記載されています。

  • channel リソースの新しい statistics.hiddenSubscriberCount プロパティには、チャンネルのチャンネル登録者数が非表示かどうかを示すブール値が含まれています。そのため、チャンネル登録者数が一般公開されている場合、プロパティの値は false になります。

  • playlists.list メソッドが onBehalfOfContentOwner パラメータと onBehalfOfContentOwnerChannel パラメータをサポートするようになりました。どちらのパラメーターも、他のいくつかのメソッドですでにサポートされています。

  • videos.list メソッドが regionCode パラメータをサポートするようになりました。このパラメータは、グラフを取得するコンテンツ領域を識別します。このパラメータは、chart パラメータと組み合わせた場合にのみ使用できます。このパラメータの値は ISO 3166-1 alpha-2 の国コードです。

  • error documentation は、複数の API メソッドで発生する可能性のある、次の新しい一般的なリクエスト エラーを示しています。

    エラーのタイプ エラーの詳細 説明
    forbidden insufficientPermissions リクエストに対して指定された OAuth 2.0 トークンに関連付けられたスコープが、リクエストされたデータにアクセスするのに不十分です。

2013 年 8 月 15 日

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

  • channel リソースの invideoPromotion オブジェクトには、次の新しいプロパティと更新されたプロパティがあります。

    • API で、ウェブサイトをプロモート アイテムとして指定できるようになりました。そのためには、invideoPromotion.items[].id.type プロパティの値を website に設定し、新しい invideoPromotion.items[].id.websiteUrl プロパティを使用して URL を指定します。また、新しい invideoPromotion.items[].customMessage プロパティを使用して、プロモーションに表示するカスタム メッセージを定義します。

      関連ウェブサイト、販売サイト、ソーシャル ネットワーク サイトなどにリンクできます。コンテンツに対してリンクを有効にする方法について詳しくは、YouTube ヘルプセンターの関連ウェブサイト販売者サイトの手順をご覧ください。

      プロモーション リンクを追加すると、それらのリンクが未承認のサイトへトラフィックをリダイレクトするために使用されることはないこと、およびプロモーション リンクが YouTube の 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 に変更されました。

  • 次のメソッドのコードサンプルが追加されました。

    また、playlistItems.insert メソッドの Python サンプルも、説明した機能が videos.rate メソッドで処理されるようになりました。

  • error documentation は、次の新しいリクエスト コンテキスト エラーを示します。これは、mine リクエスト パラメータをサポートするすべての API メソッドで発生する可能性があります。

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

2013 年 8 月 8 日

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

2013 年 7 月 30 日

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

  • channelBanner リソースで、kind プロパティの値が youtube#channelBannerInsertResponse から youtube#channelBannerResource に変更されました。このリソースは、channelBanners.insert リクエストへのレスポンスとして返されます。

  • channel リソースの新しい brandingSettings.channel.profileColor プロパティは、チャンネルのコンテンツを際立たせる目立つ色を指定します。プロパティ値は、ポンド記号(#)の後に 6 文字の 16 進文字列を続けます(#2793e6 など)。

  • この API では、チャンネル登録の対象がチャンネルのすべてのアクティビティを対象とするか、新規アップロードのみかを指定できるようになりました。subscription リソースの新しい contentDetails.activityType プロパティは、サブスクライバーに通知されるアクティビティのタイプを識別します。有効な値は alluploads です。

  • videos.list メソッドでは、YouTube で特に人気の高い動画のグラフを取得するための新しいパラメータがサポートされています。

    • chart パラメータは、取得するグラフを識別します。現在サポートされている値は mostPopular のみです。chart パラメータはフィルタ パラメータです。つまり、他のフィルタ パラメータ(idmyRating)と同じリクエスト内では使用できません。
    • videoCategoryId パラメータは、グラフを取得する動画のカテゴリを識別します。このパラメータは、chart パラメータと組み合わせた場合にのみ使用できます。デフォルトでは、グラフは特定のカテゴリに限定されません。

  • video リソースの新しい topicDetails.relevantTopicIds[] プロパティは、動画またはそのコンテンツに関連する Freebase トピック ID のリストを提供します。これらのトピックのテーマは、動画内で言及または登場する場合があります。

  • video リソースの recordingDetails.location.elevation プロパティの名前を recordingDetails.location.altitude に変更し、fileDetails.recordingLocation.location.elevation プロパティの名前を fileDetails.recordingLocation.location.altitude に変更しました。

  • video リソースの contentDetails.contentRating オブジェクトは、MPAA レーティングや TVPG レーティングなど、さまざまなレーティング方式で動画が受け取るレーティングを指定します。API では、レーティング システムごとに、動画が評価されていないことを示す評価値がサポートされるようになりました。なお、MPAA レーティングには、「レーティングなし」のレーティングは、映画のカット バージョンが公式のレーティングを受けたノーカット バージョンであることを表すためによく使用されます。

  • video リソースの新しい contentDetails.contentRating.ytRating プロパティは、年齢制限のあるコンテンツを識別します。動画に 18 歳未満のユーザーにとって不適切なコンテンツが含まれていると YouTube が判断した場合、このプロパティの値は ytAgeRestricted になります。プロパティが存在しない場合、またはプロパティ値が空の場合、そのコンテンツは年齢制限ありと見なされていません。

  • channels.list メソッドの mySubscribers パラメータが非推奨になりました。subscriptions.list メソッドとその mySubscribers パラメータを使用して、認証されたユーザーのチャンネルの登録者リストを取得します。

  • channelBanners.insertchannels.updatevideos.getRatingvideos.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 メソッドを呼び出すときにプレイリストタグを設定することもできます。

  • onBehalfOfContentOwner パラメータは、これまで channels.list メソッドと search.list メソッドでサポートされていましたが、videos.insertvideos.updatevideos.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 日

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

2013 年 5 月 14 日

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

  • スタンドアロン ページには、Java.NETPHPRuby のコードサンプルが表示されるようになりました。

  • Python のコードサンプルのリストページには、チャンネル登録の追加、再生リストの作成、動画の更新の例が追加されました。

2013 年 5 月 10 日

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

2013 年 5 月 8 日

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

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

    このデータを取得するには、channels.list リクエストの part パラメータ値に invideoPromotion を含めます。

  • 新しい channels.update メソッドを使用すると、チャンネルの動画内プロモーション キャンペーン データを更新できます。このメソッドがサポートしているのは channel リソースの invideoPromotion 部分の更新のみで、リソースの他の部分の更新はまだサポートしていません。

2013 年 5 月 2 日

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

  • チャンネル リソースで status.isLinked プロパティがサポートされるようになりました。このプロパティは、YouTube ユーザー名または Google+ アカウントにすでにリンクされているユーザーがチャンネル データによって識別されているかどうかを示します。このいずれかのリンクを持つユーザーは公開されている YouTube ID を既に持っているユーザーであり、動画のアップロードなど、いくつかの操作の前提条件となります。

  • サブスクリプション リソースが subscriberSnippet 部分をサポートするようになりました。このオブジェクトには、チャンネル登録者のチャンネルのスニペット データが含まれます。

  • API で videos.getRating メソッドがサポートされるようになりました。このメソッドは、認証されたユーザーが 1 つ以上の動画のリストに対して付けた評価を取得します。

  • videos.list メソッドの新しい myRating パラメータを使用すると、認証されたユーザーが like または dislike と評価した動画のリストを取得できます。

    myRating パラメータと id パラメータはどちらもフィルタ パラメータと見なされるようになりました。つまり、API リクエストでどちらか一方のパラメータのみを指定する必要があります。(以前は、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 に設定すると、カメラの動きによるブレを除去して動画を調整できるようになります。

  • 次のリソースの snippetchannelTitle プロパティが追加されました。

    • playlistItem – 再生リスト アイテムを追加したチャンネルの名前を指定します。
    • playlist – 再生リストを作成したチャンネルの名前を指定します。
    • subscription – このプロパティには、登録先のチャンネルの名前を指定します。

  • 次のメソッドのコードサンプルが追加されました。

  • 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 リソースには、次の新しいプロパティが含まれています。

  • playlistItems.update メソッドのドキュメントを更新し、リクエスト本文として送信されるリソースに snippet.resourceId プロパティを指定する必要があるという事実を反映しました。

  • search.list メソッドが次の機能をサポートするようになりました。

    • 新しい forMine パラメータを使用すると、検索対象を認証されたユーザーの動画のみに制限できます。

    • order パラメータで、結果をタイトルのアルファベット順(order=title)または動画の件数の降順(order=videoCount)で並べ替えることができるようになりました。

    • 新しい safeSearch パラメータは、制限されたコンテンツを検索結果に含めるかどうかを示します。

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

    エラーのタイプ エラーの詳細 説明
    badRequest invalidCategoryId snippet.categoryId プロパティに無効なカテゴリ ID が指定されています。videoCategories.list メソッドを使用して、サポートされているカテゴリを取得します。
    badRequest invalidRecordingDetails metadata specifies invalid recording details.
    badRequest invalidVideoGameRating リクエスト メタデータで指定されたビデオ ゲームの評価は無効です。
    badRequest invalidVideoMetadata リクエスト メタデータが無効です。
  • onBehalfOfContentOwner パラメータは、videos.update メソッドと videos.delete メソッドでサポートされているパラメータのリストから削除されました。

2013 年 3 月 12 日

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

  • 次のリソースの snippetchannelTitle プロパティが追加されました。

    • activity – このプロパティは、アクティビティを担当するチャンネルの名前を指定します。
    • search – 検索結果で識別されるリソースに関連付けられたチャネルの名前を指定します。
    • video – 動画をアップロードしたチャンネルの名前を指定します。

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

    • channelType パラメータを使用すると、すべてのチャンネルまたは番組のみを取得するように、チャンネルの検索を制限できます。

    • videoType パラメータを使用すると、動画の検索対象を制限して、すべての動画、または映画のみ、または番組のエピソードのみを取得できます。

  • video リソースの recordingDetails 部分の定義を更新し、動画の位置情報または録画時間が設定されている場合のみ、動画に対してオブジェクトが返されるようにしました。

  • playlistItems.update メソッドが invalidSnippet エラーを返すようになりました。これは、API リクエストに有効なスニペットが指定されていない場合に返されます。

  • いくつかの API メソッドでは、YouTube コンテンツ パートナー専用の新しいパラメータがサポートされています。YouTube コンテンツ パートナーには、映画やテレビのスタジオ、レコード レーベル、YouTube でコンテンツを提供しているその他のコンテンツ クリエイターが含まれます。

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

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

      channels.listsearch.listvideos.deletevideos.listvideos.update の各メソッドは、このパラメータをサポートしています。

    • managedByMe パラメータは channels.list メソッドでサポートされ、onBehalfOfContentOwner パラメータで指定されたコンテンツ所有者が所有するすべてのチャンネルを返すよう API に指示します。

    • forContentOwner パラメータは search.list メソッドでサポートされ、onBehalfOfContentOwner パラメータで指定されたコンテンツ所有者が所有するリソースのみが含まれるように検索結果を制限するよう API に指示します。

2013 年 2 月 25 日

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

  • API では、video リソースについて、いくつかの新しいパーツとプロパティがサポートされています。

    • fileDetailsprocessingDetailssuggestions の新しいパーツは、アップロードした動画に関する情報を動画所有者に提供します。このデータは、以下のような動画のアップロードを可能にするアプリケーションに非常に役立ちます。

      • 処理のステータスと進行状況
      • 動画の処理中に発生したエラーやその他の問題
      • サムネイル画像を使用できるかどうか
      • 動画やメタデータの品質改善に関する提案
      • YouTube にアップロードされた元のファイルに関する詳細

      これらの部分のすべてを取得できるのは、動画の所有者のみです。以下のリストでは、新しいパートについて簡単に説明しています。video リソース ドキュメントでは、各パートに含まれるすべてのプロパティを定義しています。

      • fileDetails オブジェクトには、ファイルの解像度、再生時間、音声コーデックと動画コーデック、ストリームのビットレートなど、YouTube にアップロードされた動画ファイルに関する情報が格納されます。

      • processingProgress オブジェクトには、アップロードされた動画ファイルの処理における YouTube の進捗状況に関する情報が格納されます。オブジェクトのプロパティは、現在の処理ステータスと、YouTube で動画の処理が終了するまでの残り時間を示します。また、この部分は、ファイルの詳細やサムネイル画像など、さまざまなタイプのデータやコンテンツを動画で利用できるかどうかも示しています。

        このオブジェクトは、動画をアップロードしたユーザーが、アップロードされた動画ファイルの処理の進行状況を追跡できるように、ポーリングされるように設計されています。

      • suggestions オブジェクトには、アップロードした動画の品質やメタデータの改善の機会を特定する提案が格納されます。

    • contentDetails 部分には、4 つの新しいプロパティが含まれています。これらのプロパティは、未認証のリクエストで取得できます。

      • dimension – 動画が 2D と 3D のどちらを利用できるかを示します。
      • definition – 動画が標準解像度または高解像度のどちらであるかを示します。
      • caption – 動画で字幕を使用できるかどうかを示します。
      • licensedContent – YouTube コンテンツ パートナーによって申し立てられたコンテンツが動画に含まれているかどうかを示します。

    • status 部分には、2 つの新しいプロパティが含まれています。動画の所有者は、動画を挿入または更新する際に両方のプロパティの値を設定できます。これらのプロパティは、未認証のリクエストで取得することもできます。

      • embeddable – 動画を他のウェブサイトに埋め込むことができるかどうかを示します。
      • license – 動画のライセンスを指定します。有効な値は creativeCommonyoutube です。

  • videos.listvideos.insertvideos.update メソッドの part パラメータの定義が更新され、上記で新たに追加された部分と、誤って省略された recordingDetails 部分がリストされるようになりました。

  • channel リソースの新しい contentDetails.googlePlusUserId プロパティには、チャンネルに関連付けられている Google+ プロフィール ID を指定します。この値を使用して、Google+ プロフィールへのリンクを生成できます。

  • 各サムネイル画像オブジェクトで画像の幅と高さを指定するようになりました。現在、サムネイル画像は activitychannelplaylistplaylistItemsearch resultsubscriptionvideo の各リソースで返されます。

  • playlistItems.listvideoId パラメータをサポートするようになりました。このパラメータを playlistId パラメータと組み合わせて使用すると、指定した動画を表す再生リストアイテムのみを取得できます。

    このパラメータによって識別される動画が再生リストにない場合、API は notFound エラーを返します。

  • エラー ドキュメントには、リクエストされたアクションに対してリクエストが適切に承認されていないことを示す新しい forbidden エラーが記載されています。

  • channel リソースの snippet.channelId プロパティが削除されました。リソースの id プロパティも同じ値を提供します。

2013 年 1 月 30 日

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

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

2013 年 1 月 16 日

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

  • 現在、以下のリストのメソッドと言語のコードサンプルを利用できます。

  • activity リソースが channelItem アクションを報告できるようになりました。このアクションは、YouTube が自動生成された YouTube チャンネルに動画を追加したときに発生します。(YouTube では、YouTube ウェブサイト上で注目度の高いトピックをアルゴリズムによって特定し、それらのトピックに対応するチャンネルを自動的に生成します)。

  • 次の search.list パラメータが更新されました。

    • q パラメータはフィルタとして指定されなくなりました。つまり、以下のようになります。
    • relatedToVideo パラメータの名前が relatedToVideoId に変更されました。
    • published パラメータが、publishedAfterpublishedBefore という 2 つの新しいパラメータに置き換えられました。これらについては、以下で説明します。

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

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

    リソース プロパティ名 説明
    activity contentDetails.playlistItem.playlistItemId string 再生リストのアイテムを一意に識別するために YouTube が割り当てた再生リスト アイテム ID。
    activity contentDetails.channelItem object チャンネルに追加されたリソースに関する情報を含むオブジェクト。このプロパティは、snippet.typechannelItem の場合にのみ存在します。
    activity contentDetails.channelItem.resourceId object チャンネルに追加されたリソースを識別するオブジェクト。他の resourceId プロパティと同様に、動画や再生リストなどのリソースタイプを指定する kind プロパティが含まれます。また、そのリソースを一意に識別する ID を指定する videoIdplaylistId などのプロパティのうち 1 つのみも含まれます。
    channel status object このオブジェクトは、チャンネルのプライバシー ステータスに関する情報をカプセル化します。
    channel status.privacyStatus string チャンネルのプライバシー ステータス。有効な値は privatepublic です。
    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 8601YYYY-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 メソッドを使用して、有効な値のリストを取得できます。