このページでは、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.list
、captions.update
、captions.download
、captions.delete
の各メソッドは新旧両方の字幕トラック ID をサポートします。ただし、2022 年 12 月 1 日以降、YouTube は古い字幕トラック ID のサポートを終了します。その時点で古い字幕トラック ID で API メソッドを呼び出すと、captionNotFound
エラーが発生します。
この変更に備えて、現在から 2022 年 12 月 1 日までの間に、保存されているすべての字幕トラック データを完全に置き換える予定です。つまり、字幕トラック データが保存されている動画については、現在保存されているデータを削除してから、captions.list
メソッドを呼び出して、動画の現在の字幕トラック セットを取得し、通常どおりにそのデータを API レスポンスに保存する必要があります。
2022 年 7 月 12 日
YouTube API サービスの利用規約が更新されました。詳しくは、YouTube API サービス利用規約 - 変更履歴をご覧ください。
2022 年 4 月 27 日
videos.insert
メソッドの説明を更新し、アップロードする動画の最大ファイルサイズが 128 GB から 256 GB に増加したことを記載しました。
2022 年 4 月 8 日
subscriptions.list
メソッドの myRecentSubscribers
と mySubscribers
の両方のパラメータの定義が更新され、API から返されるサブスクライバーの最大数が制限される可能性があることに注意しました。
この変更は、API の動作の変更ではなく、ドキュメントを修正するためのものです。
2021 年 12 月 15 日
2021 年 11 月 18 日にお知らせしたとおり、動画の低評価数を YouTube プラットフォーム全体で非公開にする変更と併せて、video
リソースの statistics.dislikeCount
プロパティが非公開になりました。
この変更について詳しくは、YouTube の公式ブログをご覧ください。
2021 年 11 月 18 日
動画の低評価数を YouTube プラットフォーム全体で非公開にする変更に伴い、video
リソースの statistics.dislikeCount
プロパティは 2021 年 12 月 13 日より非公開になります。つまり、API リクエストが動画の所有者によって認証された場合にのみ、videos.list
エンドポイントからの API レスポンスにプロパティが含まれます。
videos.rate
エンドポイントはこの変更の影響を受けません。
低評価数を一般公開しておらず、API クライアントの低評価数をまだ確認する必要があるデベロッパーは、免除の許可リストへの登録を申請できます。免除を申請するには、こちらの申請フォームに記入する必要があります。
この変更について詳しくは、YouTube の公式ブログをご覧ください。
2021 年 7 月 2 日
注: これはサポート終了のお知らせです。
commentThreads.update
エンドポイントは非推奨になり、サポートを終了しました。このエンドポイントは、他の API エンドポイントで利用できる機能が重複していました。代わりに、comments.update
を呼び出すことができます。
commentThreads
リソースが必要な場合は、commentThreads.list
メソッドの二次呼び出しを行います。
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.delete
、playlistItems.insert
、playlistItems.list
、playlistItems.update
、playlists.delete
、playlists.list
、playlists.update
のメソッドはすべて、新しいplaylistOperationUnsupported
エラーをサポートしています。このエラーは、特定の再生リストで許可されていない操作をリクエストが実行しようとした場合に発生します。たとえば、ユーザーがアップロードした動画の再生リストから動画を削除したり、再生リストそのものを削除したりすることはできません。いずれの場合も、
400
HTTP レスポンス コード(不正なリクエスト)が返されます。 -
playlistItems.list
メソッドのwatchHistoryNotAccessible
エラーとwatchLaterNotAccessible
エラーがドキュメントから削除されました。実際には、ユーザーの再生履歴と [後で見る] のリストに API からアクセスすることはできませんが、このような特定のエラーは API から返されません。
2020 年 10 月 15 日
デベロッパー ポリシーに、次の 2 つの新しいセクションが追加されました。
- 新しいセクション III.E.4.i では、YouTube の埋め込みプレーヤーを介して収集および送信されるデータに関する追加情報を提供しています。ユーザーがプレーヤーを操作して再生の意図を示す前に、YouTube の埋め込みプレーヤーを介して YouTube にユーザーデータを送信する場合は、すべてお客様の責任となります。自動再生を false に設定することで、ユーザーがプレーヤーを操作する前に YouTube と共有するデータを制限できます。
- 新しいセクション III.E.4.j では、コンテンツをサイトやアプリに埋め込む前に、子ども向けコンテンツ(MFK)ステータスを確認しています。デベロッパーは、API クライアントに埋め込む動画が子ども向けかどうかを把握し、それに応じて埋め込みプレーヤーから収集されたデータを処理する責任も負います。そのため、YouTube の埋め込みプレーヤーを介して API クライアントにコンテンツを埋め込む前に、YouTube Data API サービスを使用しているコンテンツのステータスを確認する必要があります。
新しい動画の 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 で利用可能なコードサンプルを掲載していたページが削除されました。
-
Java、JavaScript、PHP、Python のクイックスタート ガイドが更新されました。改訂後のガイドでは、API キーを使用してサンプルを実行する方法と、OAuth 2.0 クライアント ID を使用して API Explorer のコードサンプルを使用して別のサンプルを実行する方法を説明しています。
上記の変更は、2017 年に API ドキュメントに追加された対話型ツールに代わるものです。
2018 年 7 月 9 日
この改訂での変更内容は次のとおりです。
-
channel
リソースのsnippet.thumbnails
プロパティの定義が更新され、アプリでサムネイルを表示する場合、API レスポンスで返される画像 URL とまったく同じ画像をコードで使用する必要があることに注意しました。たとえば、アプリケーションでは API レスポンスで返される URL にhttps
ドメインではなくhttp
ドメインを使用しないでください。2018 年 7 月より、チャンネルのサムネイル URL は
https
ドメインでのみ利用できます。この URL は API レスポンスに表示されます。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 ウェブサーバー アプリケーションの完全なコードサンプルを提供するようになりました。これらのアプリケーションでは、認証フローが若干異なります。サンプル全体(およびこの変更)を表示するには:
- インタラクティブ コード スニペット ツール、または API メソッド(
channels.list
メソッドなど)のドキュメントをご覧ください。 - コードサンプルの上にある
Python
タブをクリックします。 - タブの上の切り替えをクリックすると、スニペットの表示から完全なサンプルの表示に切り替わります。
- このタブには、
InstalledAppFlow
承認フローを使用するコードサンプル全体が表示されます。サンプルの上の説明では、これについて説明しており、ウェブサーバー アプリケーションのサンプルへのリンクも含まれています。 - リンクをクリックしてウェブサーバーの例に切り替えます。このサンプルは、Flask ウェブ アプリケーション フレームワークと別の承認フローを使用します。
以下のサンプルはすべて、ローカルにダウンロードして実行するように設計されています。サンプルを実行する場合は、コード スニペット ツールの手順にある完全なコードサンプルをローカルで実行するをご覧ください。
- インタラクティブ コード スニペット ツール、または API メソッド(
2017 年 8 月 29 日
この改訂での変更内容は次のとおりです。
search.list
メソッドのforContentOwner
パラメータの定義を更新し、このパラメータがtrue
に設定されている場合、type
パラメータをvideo
に設定する必要があります。search.list
メソッドのregionCode
パラメータの定義を更新し、このパラメータによって検索結果が、指定された地域で視聴できる動画に限定されることを明確にしました。- YouTube のブランドロゴとアイコンが更新されました。新しい「Developed with YouTube」ロゴは、ブランディング ガイドラインのページからダウンロードできます。このページには他の YouTube の新しいロゴとアイコンも表示され、YouTube ブランド サイトからダウンロードできます。
2017 年 7 月 24 日
この改訂での変更内容は次のとおりです。
- iOS 用の新しい YouTube Data API クイックスタート ガイドが利用可能になりました。このガイドでは、Objective-C または Swift で記述されたシンプルな iOS アプリケーションで YouTube Data API を使用する方法について説明します。
- YouTube Data API のインタラクティブ コード スニペット ツールに、ツールの機能の一部を説明するドキュメントが追加されました。
- API リクエストの実行
- コード スニペットと完全なコードサンプルの切り替え
- ボイラープレート関数の使用
- 既存のリソースの読み込み(更新メソッドの場合)
注: このツールは、API メソッドの API リファレンス ドキュメントにも組み込まれています(例)。
2017 年 6 月 1 日
この改訂での変更内容は次のとおりです。
-
注: これはサポート終了のお知らせです。
次の
video
リソース プロパティは非推奨になります。これらのプロパティは 2017 年 12 月 1 日までサポートされますが、その時点まで動画がこれらのプロパティの値を返す保証はありません。同様に、これらのプロパティ値を設定するvideos.insert
リクエストやvideos.update
リクエストでも、この日付になるまでエラーは発生しませんが、受信データが保存されない可能性があります。
2017 年 5 月 17 日
この改訂での変更内容は次のとおりです。
-
API リファレンス ドキュメントが更新され、コード スニペットがより普遍的でインタラクティブなものになりました。
channels.list
やvideos.rate
などの API メソッドを説明するページに、Java、JavaScript、PHP、Python、Ruby、Apps Script、Go のコード スニペットを表示、カスタマイズできるインタラクティブ ツールが追加されました。このツールでは、特定のメソッドについて 1 つ以上のユースケースのコード スニペットが表示され、各ユースケースではそのメソッドを呼び出す一般的な方法が説明されています。たとえば、
channels.list
メソッドを呼び出して、特定のチャンネルや現在のユーザーのチャンネルに関するデータを取得できます。コードサンプルを操作することもできます。
-
パラメータ値とプロパティの値を変更すると、コード スニペットが動的に更新されて指定した値が反映されます。
-
コード スニペットと完全なサンプルの表示を切り替えることができます。コード スニペットは、コードのうち API メソッドを呼び出す部分を示しています。完全なサンプルには、このスニペットと、リクエストを認可および送信するためのボイラープレート コードが含まれています。完全なサンプルは、コマンドラインまたはローカル ウェブサーバーからコピーして実行できます。
-
ボタンをクリックしてリクエストを実行します。(リクエストを実行するには、ユーザーに代わって API を呼び出すツールを承認する必要があります)。
なお、API Explorer を利用可能なページで、このツールが API Explorer に代わるものです。(各ページにはリンクが表示され、API Explorer で作業中のリクエストを読み込むオプションもあります)。
-
-
Data API コード スニペット ツールも更新され、上記の機能をすべて利用できる新しい UI が導入されました。このページで利用できる主な新機能は次のとおりです。
- データを書き込む API リクエストをサポートします。
- Java サンプルのサポート。
- ユーザー認証と API リクエストの作成のための、より柔軟で包括的なボイラープレート コード。
2017 年 4 月 27 日
この改訂での変更内容は次のとおりです。
- 新しいクイックスタート ガイドでは、YouTube Data API リクエストを行う簡単なアプリケーションをセットアップする方法を説明しています。現在、Android、Apps Script、Go、Java、JavaScript、Node.js、PHP、Python、Ruby 向けのガイドが提供されています。
2017 年 3 月 30 日
この改訂での変更内容は次のとおりです。
channel
リソースの新しいtopicDetails.topicCategories[]
プロパティには、チャンネルのコンテンツについて記述した Wikipedia の URL リストが含まれています。URL は、リソースのtopicDetails.topicIds[]
プロパティで返されるトピック ID に対応しています。playlistItem
リソースの新しいcontentDetails.videoPublishedAt
プロパティは、動画が YouTube に公開された時刻を識別します。このリソースには、アイテムが再生リストに追加された時刻を識別するsnippet.publishedAt
プロパティがすでに含まれています。channel
リソースと同様に、video
リソースはtopicDetails.topicCategories[]
プロパティを返すようになりました。このプロパティには、動画コンテンツを説明する Wikipedia の URL リストが含まれています。video
リソースの場合、URL はリソースのtopicDetails.relevantTopicIds[]
プロパティで返されるトピック ID に対応します。video
リソースの新しいcontentDetails.contentRating.mpaatRating
プロパティは、アメリカ映画協会が映画の予告編やプレビューに付けたレーティングを識別します。
2017 年 2 月 27 日
最初に 2016 年 8 月 11 日にお知らせしたとおり、YouTube は、サポートされているトピック ID のリストをキュレート済みリストに切り替えました。サポートされているトピック ID の完全なリストは、channel
リソースと video
リソースの topicDetails
プロパティと、search.list
メソッドの topicId
パラメータに含まれています。
キュレート済みリストにはいくつかの変更があることに注意してください。
- 以下のトピックが
Society
のサブトピックとして追加されました。名前 トピック ID ビジネス /m/09s1f
健康 /m/0kt51
軍事 /m/01h6rj
政治 /m/05qt0
宗教 /m/06bvp
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
の子)が削除されました。
また、親カテゴリもいくつかあります(
Entertainment
、Gaming
、Lifestyle
、Music
、Sports
)。子カテゴリに関連付けられている動画(例:Tennis
)は、親カテゴリ(Sports
)にも関連付けられます。 - これまで
2016 年 11 月 10 日
この改訂での変更内容は次のとおりです。
-
2016 年 8 月 11 日に初めてお知らせしたとおり、Freebase と Freebase API のサポート終了に伴い、トピック ID に関していくつかの変更が必要になります。トピック ID は、
channel
リソースとvideo
リソースに関連付けられているトピックを識別します。また、topicId
検索パラメータを使用して、特定のトピックに関連するチャンネルや動画を検索することもできます。2017 年 2 月 10 日より、YouTube はこれまでより細かい ID のセットではなく、少数のトピック ID を返すようになります。また、チャンネルと動画が特定のトピックに関連付けられる保証はありません。これは、現在の API の動作と一致しています。
API クライアントをこうした変更に対応できるように、以下の API パラメータとプロパティの定義が更新され、今後サポートされるトピック ID のリストが記載されています。カテゴリのリストは、すべての宿泊施設で同じです。
channel
リソースのtopicDetails.topicIds[]
プロパティ。video
リソースのtopicDetails.relevantTopicIds[]
プロパティ。search.list
メソッドのtopicId
パラメータ。
-
注: これはサポート終了のお知らせです。
次のプロパティは非推奨になります。
channel
リソースのtopicDetails.topicIds[]
プロパティ。このプロパティは 2017 年 11 月 10 日までサポートされます。video
リソースのtopicDetails.relevantTopicIds[]
プロパティ。このプロパティは 2017 年 11 月 10 日までサポートされます。video
リソースのtopicDetails.topicIds[]
プロパティ。このプロパティに 2017 年 2 月 10 日以降の値は含まれません。(この日付以降は、動画に関連付けられているすべてのトピックがtopicDetails.relevantTopicIds[]
プロパティ値によって識別されます)。
-
Freebase はすでに非推奨となっているため、Freebase トピックによる検索ガイドはドキュメントから削除されました。このガイドでは、アプリが Freebase API とどのように連携するのかを示すコードサンプルを提供しました。
また、トピック ID に関連するいくつかのコードサンプルが
search.list
メソッドのドキュメントから削除されました。
2016 年 11 月 2 日
この改訂での変更内容は次のとおりです。
-
新しいプロパティとパラメータ
-
video
リソースには、いくつかの新しいプロパティが含まれています。-
player.embedHtml
プロパティには、動画を再生するプレーヤーの埋め込みに使用できる<iframe>
タグが含まれています。新しいplayer.embedHeight
プロパティとplayer.embedWidth
プロパティでは、埋め込みプレーヤーのサイズを指定します。これらのプロパティが返されるのは、API リクエストでmaxHeight
パラメータまたはmaxWidth
パラメータの少なくとも 1 つに値が指定されている場合のみです。これら 2 つの新しいパラメータについては、この変更履歴の項目で後ほど説明します。 -
新しい
hasCustomThumbnail
プロパティは、動画をアップロードしたユーザーが動画のカスタム サムネイル画像を提供しているかどうかを示します。このプロパティは、動画をアップロードしたユーザーにのみ表示されます。 -
新しい
fpbRatingReasons[]
は、動画が FPB(南アフリカ)レーティングを獲得した理由を表します。 -
新しい
mcstRating
は、ベトナムで動画が受けた評価を識別します。
-
-
videos.list
メソッドは、maxHeight
とmaxWidth
の 2 つの新しいパラメータをサポートしています。video
リソースのplayer
部分を取得する際に、どちらか一方または両方のパラメータを使用できます。デフォルトでは、
player.embedHtml
プロパティで返される<iframe>
の高さは 360 ピクセルです。幅は動画のアスペクト比に合わせて調整されるため、埋め込みプレーヤーの動画に黒い帯が表示されなくなります。たとえば、動画のアスペクト比が 16:9 の場合、プレーヤーの幅は 640 ピクセルになります。新しいパラメータを使用すると、デフォルトのサイズの代わりに、アプリのレイアウトに適した高さや幅を埋め込みコードで指定できます。API サーバーは、埋め込みプレーヤーの動画に黒い帯が表示されないよう、必要に応じてプレーヤーのサイズを調整します。どちらのパラメータも、埋め込みプレーヤーの最大サイズを指定します。そのため、両方のパラメータを指定しても、一方のディメンションはそのディメンションで許容される最大数よりも小さくなることがあります。
たとえば、動画のアスペクト比が 16:9 であるとします。したがって、
maxHeight
またはmaxWidth
パラメータが設定されていない場合、player.embedHtml
タグには 640x360 のプレーヤーが含まれます。maxHeight
パラメータが720
に設定され、maxWidth
パラメータが設定されていない場合、API は 1280x720 のプレーヤーを返します。maxWidth
パラメータが960
に設定され、maxHeight
パラメータが設定されていない場合、API は 960x540 のプレーヤーを返します。maxWidth
パラメータが960
に設定され、maxHeight
パラメータが450
に設定されている場合、API は 800x450 のプレーヤーを返します。
前述の新しい
player.embedHeight
プロパティとplayer.embedWidth
プロパティは、プレーヤーのサイズを識別します。
-
-
既存のメソッド、プロパティ、パラメータの更新
-
channelSection
リソースの説明を更新し、ターゲティング データを設定せずにチャネルで最大 10 個のセクションを作成できることと、ターゲティング データを使用して最大 100 個のセクションを作成できることを記載しました。また、
channelSection
リソースのtargeting
プロパティを更新して、ターゲティング オプションを設定できるのは API のみであるという事実を反映しました。YouTube ウェブサイトのユーザー インターフェースを使用してチャンネル セクションを変更すると、ターゲティング オプションは削除されます。 -
i18nLanguage
リソースのsnippet.name
プロパティの定義が修正されました。この値は、i18nLanguage.list
メソッドのhl
パラメータで指定された言語で記述されているので、値が言語の名前を表すことを反映しています。 -
playlistItem
リソースのcontentDetails.note
プロパティが更新され、プロパティ値の最大長が 280 文字であることを指摘しました。 -
playlistItem
リソースのcontentDetails.startAt
プロパティとcontentDetails.endAt
プロパティが非推奨になりました。これらのフィールドは、playlistItems.insert
またはplaylistItems.update
リクエストで設定されている場合は無視されます。 -
playlistItems.delete
メソッドとplaylistItems.update
メソッドがonBehalfOfContentOwner
パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。このメソッドを使用するリクエストも、https://www.googleapis.com/auth/youtubepartner
スコープへのアクセスを提供するトークンで承認する必要があります。 -
search.list
メソッドのpublishedBefore
パラメータとpublishedAfter
パラメータはどちらも更新され、パラメータ値を含むことを示すようになりました。たとえば、publishedBefore
パラメータが設定されている場合、API は指定された時刻より前に作成されたリソースまたは時刻に作成されたリソースを返します。 -
video
リソースのcontentDetails.contentRating.grfilmRating
プロパティは、grfilmK12
、grfilmK15
、grfilmK18
の 3 つの追加値をサポートします。 -
videos.insert
メソッドの説明を更新し、アップロードする動画の最大ファイルサイズが 64 GB から 128 GB に増加したことを記載しました。
-
-
新しいエラーと更新エラー
-
API では、次の新しいエラーがサポートされています。
エラーのタイプ エラーの詳細 説明 forbidden (403)
homeParameterDeprecated
activities.list
メソッドはこのエラーを返し、ユーザーのホームページのアクティビティ データがこの API を通じて取得できないことを示します。このエラーは、未承認のリクエストでhome
パラメータがtrue
に設定されている場合に発生することがあります。invalidValue (400)
invalidContentDetails
playlistItems.insert
メソッドはこのエラーを返し、リクエストのcontentDetails
オブジェクトが無効であることを示します。このエラーが発生する理由の 1 つは、contentDetails.note
フィールドが 280 文字を超えていることです。forbidden (403)
watchHistoryNotAccessible
playlistItems.list
メソッドはこのエラーを返し、リクエストが「再生履歴」の再生リスト アイテムを取得しようとしたものの、API を使用して取得できないことを示します。forbidden (403)
watchLaterNotAccessible
playlistItems.list
メソッドはこのエラーを返し、リクエストが「後で見る」再生リストのアイテムを取得しようとしたものの、API では取得できないことを示します。badRequest (400)
uploadLimitExceeded
videos.insert
メソッドはこのエラーを返し、チャンネルでアップロード可能な動画の数を超えたことを示します。forbidden (403)
forbiddenEmbedSetting
videos.update
メソッドはこのエラーを返し、API リクエストが動画に無効な埋め込み設定を試みたことを示します。一部のチャンネルでは、ライブ配信用に埋め込みプレーヤーを提供する権限がない可能性があります。詳しくは、YouTube ヘルプセンターをご覧ください。 -
重複する動画を再生リストに挿入しても、
playlistItems.insert
メソッドがエラーを返さなくなりました。このエラーは以前、お気に入りの動画などの一部の再生リストで発生していました。これらの再生リストでは、重複が許可されないものの、サポートは終了しました。一般的に、再生リストでは重複する動画を使用できます。
-
-
その他の最新情報
-
2016 年 9 月 15 日の変更履歴エントリを更新し、
channel
リソースのcontentDetails.relatedPlaylists.watchHistory
プロパティとcontentDetails.relatedPlaylists.watchLater
プロパティがレスポンスに含まれる場合は常に、それぞれHL
とWL
という値が含まれることを明確にしました。また、これらのプロパティが含まれるのは、承認されたユーザーが自身のチャンネルに関するデータを取得している場合のみです。
-
2016 年 9 月 15 日
この改訂での変更内容は次のとおりです。
-
2016 年 8 月 11 日の変更履歴の更新では、トピック ID に関連するいくつかの変更点について説明しました。その中には、サポートされるトピック 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
プロパティには、すべてのチャネルについてそれぞれHL
とWL
の値が含まれるようになりました。なお、これらのプロパティを表示できるのは、自分のチャンネルに関するデータを取得する承認済みユーザーのみです。承認済みユーザーが自身のチャンネルに関するデータを取得する場合でも、このプロパティには常に
HL
とWL
の値が含まれます。そのため、再生履歴と [後で見る] の再生リスト ID を API で取得することはできません。また、チャンネルの再生履歴または [後で見る] 再生リストについて、再生リストの詳細(
playlists.list
)や再生リストのアイテム(playlistItems.list
)を取得するリクエストに対して、空のリストが返されるようになりました。この動作は、新しい値HL
とWL
だけでなく、API クライアントがすでに保存した再生履歴や [後で見る] 再生リスト ID にも当てはまります。
-
-
video
リソースのfileDetails.recordingLocation
オブジェクトとその子プロパティは返されなくなります。これまでは、このデータ(親fileDetails
オブジェクトなど)は動画の所有者だけが取得できました。
2016 年 8 月 11 日
この改訂での変更内容は次のとおりです。
-
新たに公開された YouTube API サービス利用規約(「更新された規約」)には、現在の利用規約に加えられた更新内容が多く含まれています。詳しくは YouTube エンジニアリングとデベロッパー ブログをご覧ください。2017 年 2 月 10 日から施行される更新された利用規約に加えて、この更新には、デベロッパーが準拠する必要があるポリシーを説明する際に役立ついくつかの補足ドキュメントが含まれています。
新しいドキュメントの全セットは、更新後の本規約の変更履歴に記載されています。また、更新後の本規約または補足書類に対する今後の変更についても、その改訂履歴に記載されます。ドキュメント内のリンクから、変更履歴の変更内容をリストした RSS フィードに登録できます。
-
Freebase と Freebase API のサポート終了に伴い、トピック ID に関していくつかの変更が行われています。トピック ID は、次の API リソースとメソッドで使用されます。
channel
リソースのtopicDetails
部分は、チャンネルに関連付けられたトピックを識別します。video
リソースのtopicDetails
部分は、動画に関連付けられているトピックを識別します。search.list
メソッドのtopicId
パラメータを使用すると、特定のトピックに関連する動画やチャンネルを検索できます。
これらの機能の変更点は次のとおりです。
-
2017 年 2 月 10 日より、YouTube はこれまでよりも詳細な ID のセットではなく、少数のトピック ID を返すようになります。このサポートされるトピックのセットは、スポーツやバスケットボールなどの大まかな分類を示しますが、特定のチームや選手は識別されません。この変更について余裕を持ってご準備いただけるよう、サポート対象のトピックを発表する予定です。
-
すでに取得している Freebase トピック ID は、2017 年 2 月 10 日までコンテンツの検索に使用できます。ただし、この期間を過ぎると、前の項目で特定した少数のトピックのみを使用して、トピック別に検索結果を取得できるようになります。
-
2017 年 2 月 10 日以降に、サポートされるより小さいトピック ID セットにないトピック ID を使用して結果を検索しようとすると、API は空の結果セットを返します。
-
2016 年 9 月 12 日をもって、次の API フィールドおよびパラメータが非推奨となります。
-
activities.list
メソッドのhome
パラメータにより、承認済みユーザーはそのユーザーの YouTube ホームページに表示されるアクティビティ フィードを取得できるようになりました。2016 年 9 月 12 日以降にこのパラメータを使用するリクエストは、空のリストを返します。 -
channel
リソースのcontentDetails.relatedPlaylists.watchHistory
プロパティとcontentDetails.relatedPlaylists.watchLater
プロパティは、ユーザー自身のチャンネルに関するデータを取得する承認済みユーザーにのみ表示されます。2016 年 9 月 12 日以降、contentDetails.relatedPlaylists.watchHistory
はHL
の値を返し、contentDetails.relatedPlaylists.watchLater
プロパティの値はすべてのチャネルについてWL
の値を返します。2016 年 9 月 12 日以降、チャンネルの再生履歴または [後で見る] 再生リストについて、再生リストの詳細(
playlists.list
)を取得するリクエストに対して、空のリストが返されます。これらのプレイリストのいずれかに含まれるプレイリスト アイテム(playlistItems.list
)を取得するリクエストも、それ以降は空のリストを返します。これは、新しい値HL
とWL
のほかに、API クライアントがすでに保存した再生履歴や [後で見る] の再生リスト ID にも当てはまります。 -
2016 年 9 月 12 日を過ぎると、
video
リソースのfileDetails.recordingLocation
オブジェクトとその子プロパティは返されなくなります。親fileDetails
オブジェクトを取得できるのは動画の所有者に限られるため、このデータは動画の所有者のみが取得できます。
-
2016 年 6 月 13 日
この改訂での変更内容は次のとおりです。
-
channel
リソースのcontentDetails.googlePlusUserId
プロパティが非推奨になりました。これまで、このプロパティは、チャンネルが Google+ プロフィールに関連付けられている場合にのみ表示されていました。サポート終了後は、このプロパティはどのchannel
リソースにも含まれなくなります。 -
comment
リソースのsnippet.authorGoogleplusProfileUrl
プロパティが非推奨になりました。これまで、このプロパティは、チャンネルが Google+ プロフィールに関連付けられている場合にのみ表示されていました。サポート終了後は、このプロパティはどのcomment
リソースにも含まれなくなります。
これらのプロパティは、サポート終了後はどちらも返されなくなるため、対応するリソース ドキュメントから削除されました。
2016 年 5 月 31 日
この改訂での変更内容は次のとおりです。
-
subscriptions.list
メソッドの新しいmyRecentSubscribers
パラメータは、認証されたユーザーのチャンネル登録者のリストを、チャンネル登録した日時の新しい順に取得します。新しいパラメータでサポートされるのは、認証されたユーザーのチャンネルの最新のチャンネル登録者 1,000 人のみであることに注意してください。サブスクライバーの完全なリストを取得するには、
mySubscribers
パラメータを使用します。このパラメータは特定の順序で定期購読者を返さないため、取得できる登録者の数は制限されません。 -
activity、playlistItem、playlist、search result、thumbnail、video の各リソースの
snippet.thumbnails.(key)
プロパティの定義が更新され、一部の動画で追加のサムネイル画像サイズが利用できるようになりました。standard
の画像は、幅 640 ピクセル、高さ 480 ピクセルです。maxres
の画像は、幅 1,280 ピクセル、高さ 720 ピクセルです。
-
channelSection.list
メソッドのpart
パラメータの定義を更新し、targeting
部分は2
割り当てユニットの費用で取得できることを記載しました。 -
videos.list
メソッドは、権限が適切でないリクエストがvideo
リソースのfileDetails
、processingDetails
、またはsuggestions
部分を取得しようとしたときに、forbidden(403
)エラーを返すようになりました。これらの部分は、動画の所有者のみが利用できます。
2016 年 5 月 17 日
新しい Data API コード スニペット ツールは、YouTube Data API の一般的なユースケース向けの短いコード スニペットを提供します。コード スニペットは現在、Apps Script、Go、JavaScript、PHP、Python、Ruby の読み取り専用のすべての API メソッドで利用できます。
ツールでは、メソッドごとに 1 つ以上のユースケースのコードサンプルが表示されます。たとえば、search.list
メソッドの 5 つのコード スニペットを以下に示します。
- キーワード別に動画を一覧表示する
- 地域別に動画を一覧表示する
- ライブイベントを一覧表示する
- 認証されたユーザーの動画を検索する
- 関連動画を一覧表示する
ツールは、ユースケースごとに API リクエストで使用されているパラメータを表示します。パラメータ値を変更できます。その場合、ツールによってコード スニペットが更新され、指定したパラメータ値が反映されます。
最後に、ツールは各リクエストに対する API レスポンスを表示します。リクエスト パラメータを変更した場合、API レスポンスは指定したパラメータ値に基づきます。API レスポンスを表示するには、ツールがユーザーに代わってリクエストを送信することを承認する必要があります。
2016 年 4 月 28 日
この改訂での変更内容は次のとおりです。
-
video
リソースの新しいcontentDetails.projection
プロパティには、動画の投影形式を指定します。有効な値は360
とrectangular
です。 -
video
リソースのrecordingDetails.location
プロパティとfileDetails.recordingLocation
プロパティは、どちらも更新され、2 つのプロパティの違いが説明されています。recordingDetails.location
プロパティは、動画の所有者が動画に関連付ける場所を識別します。この場所は編集可能で、公開動画の場合は検索可能です。また、公開動画の場合はユーザーに表示される場合があります。fileDetails.recordingLocation
プロパティ値は不変で、アップロードされた元の動画ファイルに関連付けられた場所を表します。この値は動画所有者にのみ表示されます。
-
channel
リソースのcontentDetails.relatedPlaylists.favorites
プロパティの定義を更新し、プロパティ値に空の再生リストを参照する再生リスト ID が含まれている可能性があることに注意してください。この ID は取得できません。これは、お気に入りの動画の機能がすでに廃止されているためです。このプロパティは API 非推奨ポリシーの対象ではありません。 -
comments.insert
、comments.update
、commentThreads.insert
、またはcommentThreads.update
メソッドによって返されるineligibleAccount
エラーの定義を更新し、API リクエストの認可に使用された YouTube アカウントがユーザーの Google アカウントと統合されていない場合に発生することを反映しました。
2016 年 4 月 20 日
この改訂での変更内容は次のとおりです。
-
channels.update
メソッドのpart
パラメータの定義が更新され、localizations
もこのパラメータの有効な値であることにご注意ください。 -
スタートガイドの割り当て使用量セクションが更新され、Google 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.insert
、channelSections.update
、channelSections.delete
の各メソッドは、このエラーを返して、指定されたチャンネル セクションを作成、更新、削除できないことを示します。badRequest (400)
styleRequired
channelSections.insert
メソッドとchannelSections.update
メソッドはこのエラーを返し、API リクエストで送信されたchannelSection
リソースでsnippet.style
プロパティの値を指定する必要があることを示します。badRequest (400)
typeRequired
channelSections.insert
メソッドとchannelSections.update
メソッドはこのエラーを返し、API リクエストで送信されたchannelSection
リソースでsnippet.type
プロパティの値を指定する必要があることを示します。badRequest (400)
processingFailure
commentThreads.list
メソッドはこのエラーを返し、API サーバーがリクエストを正常に処理できなかったことを示します。これは一時的なエラーの可能性がありますが、通常はリクエストの入力が無効であることを示します。リクエストの本文のcommentThread
リソースの構造を調べて、有効であることを確認します。forbidden (403)
commentsDisabled
commentThreads.list
メソッドはこのエラーを返し、videoId
パラメータで識別される動画でコメントが無効になっていることを示します。badRequest (400)
commentTextTooLong
commentThreads.insert
メソッドはこのエラーを返し、挿入されているcomment
リソースのsnippet.topLevelComment.snippet.textOriginal
プロパティに含まれる文字数が多すぎることを示します。invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
playlistItems.insert
メソッドはこのエラーを返し、再生リストに追加しようとしている動画がすでに別のシリーズ再生リストに含まれていることを示します。シリーズリストについて詳しくは、YouTube ヘルプセンターをご覧ください。badRequest (400)
subscriptionForbidden
subscriptions.insert
メソッドはこのエラーを返し、サブスクリプションが上限に達したか、最近作成したサブスクリプションが多すぎることを示します。後者の場合、数時間後にリクエストを再試行できます。badRequest (400)
invalidCategoryId
videos.update
メソッドはこのエラーを返し、アップロードされたvideo
リソースのsnippet.categoryId
プロパティに無効なカテゴリ ID が指定されていることを示します。videoCategories.list
メソッドを使用して、サポートされているカテゴリを取得します。badRequest (400)
invalidDescription
videos.update
メソッドはこのエラーを返し、アップロードされたvideo
リソースのsnippet.description
プロパティに無効な値が指定されたことを示します。badRequest (400)
invalidPublishAt
videos.update
メソッドはこのエラーを返し、アップロードされたvideo
リソースのstatus.publishAt
プロパティに無効な公開予約時刻が指定されていることを示します。badRequest (400)
invalidRecordingDetails
videos.update
メソッドはこのエラーを返し、アップロードされたvideo
リソースのrecordingDetails
オブジェクトに無効な録音の詳細を指定したことを示します。badRequest (400)
invalidTags
videos.update
メソッドはこのエラーを返し、アップロードされたvideo
リソースのsnippet.tags
プロパティに無効な値が指定されたことを示します。badRequest (400)
invalidTitle
videos.update
メソッドはこのエラーを返し、アップロードされたvideo
リソースのsnippet.title
プロパティに無効な動画タイトルまたは空の動画タイトルが指定されていることを示します。badRequest (400)
invalidVideoMetadata
videos.update
メソッドはこのエラーを返し、リクエスト メタデータが無効であることを示します。このエラーは、リクエストでvideo
リソースのsnippet
部分を更新したものの、snippet.title
プロパティとsnippet.categoryId
プロパティの両方に値が設定されていない場合に発生します。
2015 年 12 月 18 日
欧州連合(EU)の法律では、EU 域内のエンドユーザーに対して特定の開示を行い、エンドユーザーから同意を得ることが義務付けられています。そのため、欧州連合(EU)のエンドユーザーに対しては、EU ユーザーの同意ポリシーを遵守する必要があります。YouTube API 利用規約に、この要件に関する通知を追加しました。
2015 年 11 月 19 日
API で、playlist
リソースと video
リソースの snippet.title
プロパティと snippet.description
プロパティ、channelSection
リソースの snippet.title
プロパティ、channel
リソースの snippet.description
プロパティについて、ローカライズされたテキストを設定および取得できるようになりました。
-
ローカライズしたタイトルと説明の設定
リソースのローカライズされた値を設定するには、そのリソースの
insert
メソッドまたはupdate
メソッドを呼び出します。リソースにローカライズされた値を設定するには、次の両方を行います。-
リソースの
snippet.defaultLanguage
プロパティに値が設定されていることを確認します。このプロパティは、リソースのsnippet.title
プロパティとsnippet.description
プロパティの言語を識別します。値には、サポートされているアプリケーション言語や他のほとんどの ISO 639-1:2002 言語コードを指定できます。たとえば、英語のタイトルと説明の動画をアップロードする場合は、snippet.defaultLanguage
プロパティをen
に設定します。channel
リソースの更新に関する注意:channel
リソースのsnippet.defaultLanguage
プロパティを設定するには、実際にはbrandingSettings.channel.defaultLanguage
プロパティを更新する必要があります。 -
更新するリソースに
localizations
オブジェクトを追加します。各オブジェクト キーは、アプリケーション言語または ISO 639-1:2002 言語コードを識別する文字列です。各キーは、リソースのローカライズされたタイトル(および説明)を含むオブジェクトにマッピングされます。以下のサンプル スニペットでは、リソースのデフォルト言語を英語に設定しています。また、ローカライズしたドイツ語とスペイン語のタイトルと説明を動画に追加します。
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
重要: リソースのローカライズ済みデータを更新する場合、API リクエストに既存のローカライズ済みバージョンのデータがすべて含まれている必要があります。たとえば、上記の例で、動画にポルトガル語のデータを追加する後続のリクエストを送信した場合、そのリクエストにドイツ語、スペイン語、ポルトガル語にローカライズされたデータを含める必要があります。
-
-
ローカライズされた値の取得
API では、次の 2 つの方法でリソースのローカライズされた値を取得できます。
-
hl
パラメータをchannels.list
、channelSections.list
、playlists.list
、videos.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.update
、channelSections.insert
、channelSections.update
、playlists.insert
、playlists.update
、videos.insert
、videos.update
メソッドは、このエラーをサポートします。badRequest (400)
localizationValidationError
このエラーは、リソースの localizations
オブジェクト内の値の 1 つが検証できなかったことを示します。このエラーは、たとえばオブジェクトに無効な言語コードが含まれている場合に発生することがあります。channels.update
、channelSections.insert
、channelSections.update
、playlists.insert
、playlists.update
の各メソッドは、このエラーをサポートします。
2015 年 11 月 4 日
この改訂での変更内容は次のとおりです。
-
既存のリソースとメソッドの更新
-
search.list
メソッドのorder
パラメータが更新され、ライブ ブロードキャストをviewCount
で並べ替えると、ブロードキャストの継続中に API の結果がブロードキャストの同時視聴者数で並べ替えられることに注意されました。 -
search.list
メソッドのrelatedToVideoId
パラメータが更新され、このパラメータが設定されている場合、サポートされている他のパラメータは、part
、maxResults
、pageToken
、regionCode
、relevanceLanguage
、safeSearch
、type
(video
に設定する必要があります)、fields
のみであることを明記しました。今回の更新は、API の動作の変更を反映するものではありません。 -
video
リソースのsnippet.publishedAt
プロパティの定義を更新し、プロパティ値(動画の公開日時を指定する)が動画がアップロードされた日時と異なる可能性があることを指摘しました。たとえば、動画を非公開動画としてアップロードし、後で公開にした場合、このプロパティ値は、動画が公開された時刻を示します。更新された定義では、非公開動画と限定公開の動画に関する値の入力方法も説明されています。この変更は API の動作の変更を反映するものではありません。
-
video
リソースのstatus.publishAt
プロパティの定義が更新され、次の点に注意してください。videos.update
メソッドを呼び出すときにこのプロパティの値を設定する場合は、動画がすでに非公開であっても、status.privacyStatus
プロパティの値をprivate
に設定する必要があります。- 過去のある時点に動画を公開するようにリクエストした場合、動画はすぐに公開されます。そのため、
status.publishAt
プロパティに過去の日時を設定した場合は、動画のprivacyStatus
をprivate
からpublic
に変更した場合と同じことになります。
-
video
リソースのcontentDetails.contentRating.cncRating
プロパティには、フランスの委員会による映画監督による動画のレーティングを指定します。このプロパティは、非推奨になったcontentDetails.contentRating.fmocRating
プロパティに代わるものです。 -
channel
リソースの brandingSettings.channel.keywords の定義が更新され、以前ドキュメント化されたとおり、プロパティ値にカンマ区切りのリストではなくスペース区切りのリストが含まれることが正しく反映されました。今回の更新は、API の動作の変更を反映するものではありません。 -
アップロードして動画に関連付けるサムネイル画像がリクエストの本文に含まれていることが正確に反映されるよう、
thumbnails.set
メソッドのドキュメントが更新されました。リクエストの本文にthumbnail
リソースが含まれていません。以前のドキュメントでは、このメソッドを呼び出すときはリクエスト本文を指定すべきではないと記載されていました。今回の更新は、API の動作の変更を反映するものではありません。 -
現在、
activities.list
メソッドに新しい動画のコメントに関連するリソースが含まれていないことを反映して、activity
リソースの説明を更新しました。リソースのsnippet.type
とcontentDetails.comment
も更新されました。
-
-
新しいエラーと更新エラー
-
API で次のエラーがサポートされるようになりました。
エラーの詳細 activities.insert
HTTP レスポンス コード badRequest (400)
理由 invalidMetadata
説明 kind
プロパティが、指定された ID のタイプと一致しません。commentThreads.update
comments.insert
comments.update
HTTP レスポンス コード badRequest (400)
理由 commentTextTooLong
説明 挿入または更新対象の comment
リソースのsnippet.topLevelComment.snippet.textOriginal
プロパティに含まれる文字数が多すぎます。playlistItems.insert
playlistItems.update
HTTP レスポンス コード forbidden (403)
理由 playlistItemsNotAccessible
説明 リクエストは、指定された再生リスト アイテムを挿入、更新、削除するための適切な承認を得ていません。 playlists.delete
playlists.insert
playlists.update
HTTP レスポンス コード badRequest (400)
理由 playlistForbidden
説明 この操作は禁止されているか、リクエストが適切に認証されていません。 search.list
HTTP レスポンス コード badRequest (400)
理由 invalidLocation
説明 location
またはlocationRadius
(あるいはその両方)のパラメータ値の形式が正しくありません。search.list
HTTP レスポンス コード badRequest (400)
理由 invalidRelevanceLanguage
説明 relevanceLanguage
パラメータ値の形式が正しくありません。subscriptions.insert
HTTP レスポンス コード badRequest (400)
理由 subscriptionForbidden
説明 このエラーは、次のいずれかに該当する場合に発生します。 - 作成しようとしているサブスクリプションはすでに存在しています
- サブスクリプションの数がすでに上限に達しています
- ご自身のチャンネルを登録しようとしていますが、これはサポートされていません。
- 最近作成したサブスクリプションの数が多すぎるため、数時間待ってからリクエストを再試行してください。
videos.update
HTTP レスポンス コード badRequest (400)
理由 invalidDefaultBroadcastPrivacySetting
説明 リクエストは、デフォルトのブロードキャストに無効なプライバシー設定を指定しようとしています。
-
2015 年 8 月 28 日
この改訂での変更内容は次のとおりです。
-
既存のリソースとメソッドの更新
-
video
リソースのstatistics.favoriteCount
プロパティが非推奨になりました。Google のサポート終了ポリシーに従い、このプロパティは、この発表から少なくとも 1 年間は
video
リソースに引き続き含まれます。ただし、プロパティ値は常に0
に設定されるようになりました。
-
2015 年 8 月 7 日
この改訂での変更内容は次のとおりです。
-
既存のリソースとメソッドの更新
-
video
リソースのsnippet.tags[]
プロパティの定義が更新され、API サーバーがプロパティの値の長さを計算する方法に関する詳細情報が提供されます。なお、今回の更新は API の動作の変更を反映するものではありません。具体的には、タグにスペースが含まれている場合、API サーバーはタグ値が引用符で囲まれている場合と同様に処理され、引用符が文字数制限にカウントされることが定義に示されています。したがって、文字数制限のため、タグ Foo-Baz には 7 文字が含まれていますが、タグ Foo Baz には 9 文字が含まれています。
-
commentThreads.insert
メソッドでshareOnGooglePlus
パラメータがサポートされなくなりました。以前は、コメントとそのコメントへの返信も投稿者の Google+ プロフィールに投稿する必要があるかどうかを指定していました。リクエストでパラメータが送信されると、API サーバーではパラメータは無視されますが、それ以外の場合はリクエストを処理します。
-
2015 年 6 月 18 日
この改訂での変更内容は次のとおりです。
-
既存のリソースとメソッドの更新
-
commentThreads.list
メソッドの新しいorder
パラメータには、API レスポンスがコメント スレッドをリストする順序を指定します。スレッドは時間または関連性で並べ替えることができます。デフォルトの動作では、時系列順に並べられます。 -
video
リソースの新しいsnippet.defaultAudioLanguage
プロパティには、動画のデフォルトの音声トラックで話されている言語を指定します。 -
video
リソースのcontentDetails.licensedContent
プロパティの定義を更新し、コンテンツが YouTube コンテンツ パートナーにリンクされているチャンネルにアップロードされ、その後そのパートナーによって申し立てが行われている必要があることを明確にしました。これは実際の API の動作を変更するものではありません。 -
captions.delete
、captions.download
、captions.insert
、captions.list
、captions.update
の各メソッドがonBehalfOfContentOwner
パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。このメソッドを使用するリクエストも、https://www.googleapis.com/auth/youtubepartner
スコープへのアクセスを提供するトークンで承認する必要があります。
-
-
新しいエラーと更新エラー
-
API で次のエラーがサポートされるようになりました。
エラーの詳細 videos.rate
HTTP レスポンス コード badRequest (400)
理由 emailNotVerified
説明 ユーザーは動画を評価する前にメールアドレスを確認する必要があります。 videos.rate
HTTP レスポンス コード badRequest (400)
理由 videoPurchaseRequired
説明 レンタル動画を評価できるのは、その動画をレンタルしたユーザーのみです。 -
subscriptions.delete
メソッドとsubscriptions.insert
メソッドで、accountClosed
エラーとaccountSuspended
エラーがサポートされなくなりました。
-
2015 年 4 月 27 日
この改訂での変更内容は次のとおりです。
-
新しいリソースとメソッド
-
新しい
videoAbuseReportReason
リソースには、不適切なコンテンツが動画に含まれていると報告される理由に関する情報が含まれています。videoAbuseReportReasons.list
メソッドを使用すると、動画が報告される理由の全リストを取得できます。 -
新しい
videos.reportAbuse
メソッドを使用すると、不適切なコンテンツを含む動画を実際に報告できます。リクエストの本文には、報告する動画と、不適切なコンテンツが含まれていると判断される理由を指定する JSON オブジェクトが含まれます。正当な理由は、上記のvideoAbuseReportReason.list
メソッドから取得できます。移行ガイドも更新され、不正な動画を報告する例が追加されました。この変更により、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 つのターゲティング オプションを利用できます。ユーザーがチャンネル セクションを表示するには、すべてのターゲット設定を満たしている必要があります。
-
targeting.languages[]
: YouTube アプリケーションの言語のリスト。これらの言語を選択しているユーザーは、対応するチャンネル セクションを表示できます。 -
targeting.regions[]
: YouTube の優先コンテンツの地域のリスト。チャンネル セクションは、特定の地域を選択したユーザーと、その地域が自動的に選択されたユーザーに表示されます。 -
targeting.countries[]
: チャンネル セクションが表示される国のリスト。リスト内の各値は ISO 3166-1 alpha-2 国コードです。
-
-
video
リソースのcontentDetails.duration
プロパティの定義が修正されました。この値は、時間、日などを反映できることを反映しています。 -
channelSections.delete
、playlistItems.delete
、playlists.delete
、subscriptions.delete
、videos.delete
メソッドのドキュメントを更新し、これらのメソッドが成功すると HTTP204
レスポンス コード(No Content
)を返すことを反映しました。
-
-
新しいエラーと更新エラー
-
API で次のエラーがサポートされるようになりました。
エラーのタイプ エラーの詳細 説明 badRequest (400)
targetInvalidCountry
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.insert
、comments.update
、comments.markAsSpam
、comments.setModerationStatus
、comments.delete
、commentThreads.insert
、commentThreads.update
の各メソッドを呼び出すには、API の新しいhttps://www.googleapis.com/auth/youtube.force-ssl
スコープ(2015 年 4 月 2 日の変更履歴に記載)が必要です。 -
-
新しいプッシュ通知の登録ガイドでは、PubSubHubBub(ウェブアクセス可能なリソースのためのサーバー間パブリッシュ/サブスクライブ プロトコル)を介したプッシュ通知の API の新しいサポートについて説明しています。PubSubHubBub コールバック サーバーは、チャンネルが次のいずれかのアクティビティを行ったときに、Atom フィード通知を受け取ることができます。
- 動画をアップロードした
- 動画のタイトルを更新する
- 動画の説明を更新したとき
-
移行ガイドも更新され、プッシュ通知の新しいサポートに関する説明が追加されました。ただし、v2 API は v3 API ではサポートされていない他の種類のプッシュ通知もサポートしていたため、PubSubHubBub のサポートについては、このガイドの非推奨セクションに引き続き記載されています。
-
API の新しい
https://www.googleapis.com/auth/youtube.force-ssl
スコープが、これまでhttps://www.googleapis.com/auth/youtube
スコープをサポートしていたすべての API メソッドで有効なスコープになりました。 -
API で次のエラーがサポートされるようになりました。
エラーのタイプ エラーの詳細 説明 badRequest (400)
invalidRating
videos.rate
メソッドは、リクエストのrating
パラメータに予期しない値が含まれていた場合に、このエラーを返します。 -
subscriptions.insert
メソッドでsubscriptionLimitExceeded
エラーがサポートされなくなりました。以前は、リクエストで特定されたサブスクライバーがサブスクリプションのレート制限を超えていることが示されていました。
2015 年 4 月 2 日
この改訂での変更内容は次のとおりです。
-
新しい
captions
リソースは、YouTube の字幕トラックを表します。字幕トラックは、1 つの YouTube 動画とのみ関連付けられます。 -
移行ガイドも更新され、v2 API の字幕機能をまだ使用しているアプリケーションを移行する方法について説明しています。
-
API の新しい
https://www.googleapis.com/auth/youtube.force-ssl
スコープでは、API サーバーとの通信が SSL 接続を介して行われる必要があります。この新しいスコープは、
https://www.googleapis.com/auth/youtube
スコープと同じアクセス権を付与します。YouTube API サーバーは HTTPS エンドポイント経由でしか利用できないため、この 2 つのスコープは機能的には同じです。その結果、https://www.googleapis.com/auth/youtube
スコープでは SSL 接続は必要ありませんが、実際には他の方法で API リクエストを発行することはできません。caption
リソースのすべてのメソッドを呼び出すには、新しいスコープが必要です。
2015 年 3 月 11 日
この改訂での変更内容は次のとおりです。
-
YouTube Data API(v3)移行ガイドには、[v3 API の新機能] という新しいタブがあり、v3 API でサポートされている機能と v2 API でサポートされていない機能がリストされています。ガイドの他のタブでは、以前と同じ機能をご利用いただけます。たとえば、チャンネルの動画内プロモーション キャンペーン データの更新方法を説明する新機能は、[チャンネル(プロフィール)] タブにも表示されます。
-
YouTube Data API(v3)移行ガイドを更新し、v3 API が次の v2 API 機能をサポートすることを記載しました。
-
YouTube Data API(v3)移行ガイドが更新され、次の v2 API 機能は v3 API でサポートされなくなることを記載しました。
-
おすすめの動画を取得する – v3 API は、現在の API ユーザーにおすすめの動画のみを含むリストは取得しません。ただし、v3 API を使用しておすすめ動画を検索するには、
activities.list
メソッドを呼び出し、home
パラメータ値をtrue
に設定します。API レスポンスでは、
snippet.type
プロパティの値がrecommendation
の場合、リソースはおすすめの動画に対応します。その場合、contentDetails.recommendation.reason
プロパティとcontentDetails.recommendation.seedResourceId
プロパティには、動画がおすすめされた理由に関する情報が含まれます。レスポンスに、特定の数のおすすめ動画が含まれているとは限りません。 -
新しい登録チャンネルの動画を取得する – v3 API では、API ユーザーが登録しているチャンネルに最近アップロードされた動画のみを含むリストは取得されません。ただし、v3 API を使用して新しい定期購入動画を探すには、
activities.list
メソッドを呼び出してhome
パラメータ値をtrue
に設定します。API レスポンスでは、
snippet.type
プロパティの値がupload
の場合、リソースは新しい定期購入動画に対応します。レスポンスに、特定の数の新しいチャンネル登録動画が含まれているという保証はありません。 -
フィード更新のプッシュ通知 – v2 API は 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.list
、channelSections.list
、guideCategories.list
、playlistItems.list
、playlists.list
、subscriptions.list
、videoCategories.list
、videos.list
のメソッドはすべてid
パラメータをサポートしています。このパラメータを使用すると、ID(動画 ID、チャンネル ID など)のカンマ区切りリストを指定できます。これらのメソッドを使用すると、1 回のリクエストで複数のリソースのリストを取得できます。
この変更に伴い、このガイドでは、古い(v2)API でサポートされていた機能のうち、現在の API バージョン(v3)でサポートが終了するすべての機能を確認するようになりました。
-
2015 年 3 月 4 日
この改訂での変更内容は次のとおりです。
-
channelSections.delete
メソッドとchannelSections.update
メソッドがonBehalfOfContentOwner
パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。 -
次のプロパティとその子プロパティは非推奨になりました。
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
注: これらのプロパティはいずれも API サポート終了ポリシーの対象ではありませんでした。
-
video
リソースの新しいcontentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
プロパティは、動画が DJCQT(ブラジル)レーティングを受けた理由を説明するものです。 -
API で次のエラーがサポートされるようになりました。
エラーのタイプ エラーの詳細 説明 notFound (404)
channelNotFound
見つからないチャンネルがリクエストの id
パラメータで指定されている場合、channels.update
メソッドはこのエラーを返します。badRequest (400)
manualSortRequiredinvalidValue
playlistItems.insert
メソッドとplaylistItems.update
メソッドは、リクエストがプレイリスト アイテムの位置を設定しようとしたときに、プレイリストが手動並べ替えを使用していない場合に、このエラーを返します。たとえば、再生リストのアイテムを日付や人気で並べ替えることができます。このエラーに対処するには、リクエスト本文で送信されたリソースからsnippet.position
要素を削除します。再生リストのアイテムをリスト内の特定の位置に配置するには、まず再生リストの順序設定を [手動] に更新する必要があります。この設定は YouTube の [動画の管理] で調整できます。forbidden (403)
channelClosed
閉鎖されたチャンネルがリクエストの channelId
パラメータで指定されている場合、playlists.list
メソッドはこのエラーを返します。forbidden (403)
channelSuspended
停止されているチャンネルがリクエストの channelId
パラメータで指定されている場合、playlists.list
メソッドはこのエラーを返します。forbidden (403)
playlistForbidden
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
プロパティは、ニュージーランドのフィルム・文学分類局による動画のレーティングを識別するもので、oflcRp13
とoflcRp16
という 2 つの新しいレーティングがサポートされるようになりました。これらは、それぞれRP13
評価とRP16
評価に対応しています。 -
channelBanners.insert
メソッドが次のエラーをサポートするようになりました。エラーのタイプ エラーの詳細 説明 badRequest
bannerAlbumFull
チャンネル所有者の YouTube チャンネル アート アルバムに含まれる画像が多すぎます。チャンネル所有者は、http://photos.google.com にアクセスしてアルバム ページに移動し、そのアルバムの画像からいくつかの画像を削除する必要があります。
2014 年 9 月 12 日
この改訂での変更内容は次のとおりです。
-
指定されたリソースパートのコストに加えて、
search.list
メソッドの呼び出しの割り当てコストが 1 ユニットから 2 ユニットに変更されました。
2014 年 8 月 13 日
この改訂での変更内容は次のとおりです。
-
subscriptions.insert
メソッドが次のエラーをサポートするようになりました。エラーのタイプ エラーの詳細 説明 badRequest
subscriptionLimitExceeded
リクエストで特定されたサブスクライバーがサブスクリプションのレート制限を超えています。追加の定期購入は数時間後に再試行できます。
2014 年 8 月 12 日
この改訂での変更内容は次のとおりです。
-
新しいガイド「アプリケーションを YouTube Data API(v3)に移行する」では、YouTube Data API(v3)を使用して、YouTube Data API(v2)で利用可能な機能を実行する方法を説明しています。古い API は 2014 年 3 月 4 日に正式に非推奨となっています。このガイドでは、現在も v2 API を使用しているアプリケーションを最新の API バージョンに移行する方法を説明します。
2014 年 7 月 8 日
この改訂での変更内容は次のとおりです。
-
playlists.insert
メソッドが次のエラーをサポートするようになりました。エラーのタイプ エラーの詳細 説明 badRequest
maxPlaylistExceeded
このエラーは、チャンネルの再生リストの数が上限に達したため、再生リストを作成できない場合に発生します。
2014 年 6 月 18 日
この改訂での変更内容は次のとおりです。
-
各 API メソッドの説明を更新し、そのメソッドの呼び出しで発生した割り当てコストを記載しました。同様に、
part
パラメータの定義を更新して、API 呼び出しで取得できる各パーツの割り当て費用を指定するようにしました。たとえば、subscriptions.insert
メソッドの呼び出しの割り当てコストは約 50 ユニットになります。subscription
リソースも 3 つの部分(snippet
、contentDetails
、subscriberSnippet
)で構成され、各部分の費用は 2 ユニットです。割り当てコストは、警告なしに変更されることがあります。
-
video
リソースは、43 の新しいコンテンツ レーティング システムをサポートするようになりました。このシステムは、動画がさまざまな国家レーティング機関から受けたレーティングを識別します。新たにサポートされるレーティング システムは、アルゼンチン、オーストリア、ベルギー、2、ブルガリア、チリ(television)、チリ(映画)、チェコ、コロンビア、デンマーク、エジプト 2
2014 年 5 月 28 日
この改訂での変更内容は次のとおりです。
-
search.list
メソッドがlocation
パラメータとlocationRadius
パラメータをサポートするようになりました。これにより、地理的位置に関連付けられた動画を検索できるようになります。位置情報に基づいて結果を取得するには、リクエストで両方のパラメータの値を指定する必要があります。2 つのパラメータのいずれか一方のみがリクエストに含まれている場合、API はエラーを返します。-
location
パラメータは、円形の地理的領域の中心の緯度と経度の座標を指定します。 -
locationRadius
パラメータでは、動画に関連付けられた場所が領域の中心からどのくらい離れても、動画が検索結果に表示される場合の、最大距離を指定します。
-
2014 年 5 月 13 日
この改訂での変更内容は次のとおりです。
-
channel
リソースのinvideoPromotion.items[]
プロパティが更新され、通常、チャンネルに対して設定できるプロモート アイテムは 1 つのみであることが示されました。挿入しようとするプロモート アイテムが多すぎると、API はtooManyPromotedItems
エラー(HTTP400
ステータス コード)を返します。 -
channelSection
リソースで、新しいタイプの注目コンテンツに関する情報を追加できるようになりました。channelSection
リソースのsnippet.type
プロパティで次の値がサポートされるようになりました。postedPlaylists
- チャンネルの所有者がチャンネルのアクティビティ フィードに投稿した再生リストpostedVideos
- チャンネルの所有者がチャンネルのアクティビティ フィードに投稿した動画subscriptions
- チャンネル所有者が登録しているチャンネル
-
video
リソースの新しいcontentDetails.contentRating.ifcoRating
プロパティは、アイルランド映画分類局から動画が受けたレーティングを識別します。 -
watermark
リソースのposition.cornerPosition
プロパティの定義を更新し、透かしがプレーヤーの右上に常に表示されるようになりました。 -
search.list
メソッドのq
パラメータの定義を更新し、クエリ語句でブール演算子の NOT(-
)演算子を使用して特定の検索語句に関連する動画を除外できることを記載しました。値にブール演算子 OR(|
)演算子を使用して、複数の検索キーワードのいずれかに関連する動画を探すこともできます。 -
search.list
呼び出しに対する API レスポンスで返されるpageInfo.totalResults
プロパティの定義を更新し、値は近似値であり、正確な値ではない可能性があることを追加しました。また、最大値は 1,000,000 です。この値を使用してページ間のリンクを作成しないでください。代わりに、nextPageToken
プロパティ値とprevPageToken
プロパティ値を使用して、ページ リンクを表示するかどうかを決定します。 -
watermarks.set
メソッドとwatermarks.unset
メソッドが更新され、これらのメソッドへのリクエストに成功すると API が HTTP204
レスポンス コードを返すようになりました。
2014 年 5 月 2 日
この改訂での変更内容は次のとおりです。
-
新しい
i18nLanguage
リソースは、YouTube ウェブサイトがサポートするアプリケーション言語を識別します。アプリ言語は UI 言語と呼ばれることもあります。YouTube ウェブサイトの場合、Google アカウントの設定、ブラウザの言語、IP の場所に基づいてアプリケーションの言語を自動的に選択したり、ユーザーが YouTube サイトのフッターから必要な UI の言語を手動で選択したりすることもできます。API は、サポートされているアプリケーション言語を一覧表示するメソッドをサポートしています。サポートされている言語は、
videoCategories.list
やguideCategories.list
などの API メソッドを呼び出すときに、hl
パラメータの値として使用できます。 -
新しい
i18nRegion
リソースは、YouTube ユーザーが優先コンテンツの地域として選択できる地域を識別します。コンテンツ ロケールは、コンテンツ ロケールとも呼ばれます。YouTube ウェブサイトの場合、コンテンツの地域は YouTube ドメインやユーザーの IP の場所などのヒューリスティックに基づいて自動的に選択されます。また、ユーザーは YouTube サイトのフッターから目的のコンテンツの地域を手動で選択することもできます。この API では、サポートされているコンテンツ リージョンを一覧表示するメソッドがサポートされています。サポートされている地域コードは、
search.list
、videos.list
、activities.list
、videoCategories.list
などの API メソッドを呼び出すときにregionCode
パラメータの値として使用できます。
2014 年 4 月 7 日
この改訂での変更内容は次のとおりです。
-
新しい
channelSection
リソースには、チャンネルがおすすめとして取り上げた動画セットに関する情報が含まれています。たとえば、チャンネルの最新アップロード、特に人気の高いアップロード、1 つまたは複数の再生リストの動画などを 1 つのセクションにまとめることができます。この API では、チャンネル セクションを一覧表示、挿入、更新、削除するメソッドがサポートされています。認証されたユーザーのチャンネルのチャンネル セクションのリストを取得するには、特定のチャンネル ID を指定するか、一意のチャンネル セクション ID のリストを指定します。
エラー ドキュメントも更新され、これらの新しいメソッドに関して API がサポートするエラー メッセージについて説明しています。
-
video
リソースのfileDetails
オブジェクトの定義を更新し、動画のprocessingDetails.fileDetailsAvailability
プロパティの値がavailable
の場合にのみそのオブジェクトが返されることを説明しました。同様に、
video
リソースのsuggestions
オブジェクトの定義を更新し、動画のprocessingDetails.tagSuggestionsAvailability
プロパティまたはそのprocessingDetails.editorSuggestionsAvailability
プロパティの値がavailable
である場合にのみ、このオブジェクトが返されることを説明しました。 -
videos.insert
メソッドとvideos.update
メソッドのドキュメントを更新し、これらのメソッドを呼び出すときにstatus.publishAt
プロパティを設定できることを反映しました。 -
channel
リソースのinvideoPromotion
オブジェクトの定義を更新し、チャンネルの所有者だけがオブジェクトを取得できることを説明しました。 -
videos.rate
メソッドのパラメータ リストを更新し、そのメソッドが実際にonBehalfOfContentOwner
パラメータをサポートしていないことを反映しました。このパラメータを設定したvideos.rate
リクエストは500
エラーを返すため、これはドキュメント エラーでした。
2014 年 3 月 31 日
この改訂での変更内容は次のとおりです。
-
video
リソースの新しいstatus.publishAt
プロパティを使用すると、非公開動画の公開日時を指定できます。このプロパティを設定できるのは、動画のプライバシー ステータスがprivate
で、動画が一度も公開されていない場合のみです。この新しいプロパティは非推奨ポリシーの対象ではありません。
2014 年 3 月 13 日
この改訂での変更内容は次のとおりです。
-
API が
channel
リソースのcontentOwnerDetails
部分をサポートするようになりました。新しい部分には、チャンネルにリンクされている YouTube パートナーに関連するチャンネル データ(チャンネルにリンクされているコンテンツ所有者の ID、コンテンツ所有者とチャンネルがリンクされた日時など)が含まれます。この新しい部分は非推奨ポリシーの対象ではありません。 -
ドキュメントでは、次のプロパティについてサポートされている最大文字数がリストされるようになりました。
リソース プロパティ 最大文字数 channel
invideoPromotion.items[].customMessage
40 文字 video
snippet.title
100 文字 video
snippet.description
5,000 バイト video
snippet.tags
500 文字。プロパティ値はリストであり、リスト内のアイテム間のカンマも上限にカウントされます。 -
channel
リソースのbrandingSettings.watch.featuredPlaylistId
プロパティが非推奨になりました。値を設定しようとすると、API からエラーが返されます。 -
エラー ドキュメントでは、エラーの種類ごとに HTTP レスポンス コードを指定するようになりました。
-
API で次のエラーがサポートされるようになりました。
エラーのタイプ エラーの詳細 説明 badRequest (400)
invalidCriteria
互いに併用できないフィルタ パラメータをリクエストで指定された場合、 channels.list
メソッドはこのエラーを返します。badRequest (400)
channelTitleUpdateForbidden
チャンネルの brandingSettings
部分を更新してbrandingSettings.channel.title
プロパティの値を変更しようとすると、channels.update
メソッドはこのエラーを返します。(プロパティを省略しても、API はエラーを返しません)。badRequest (400)
invalidRecentlyUploadedBy
invideoPromotion.items[].id.recentlyUploadedBy
プロパティに無効なチャンネル ID が指定されている場合、channels.update
メソッドはこのエラーを返します。badRequest (400)
invalidTimingOffset
invideoPromotion
部分に無効なタイミング オフセットが指定されている場合、channels.update
メソッドはこのエラーを返します。badRequest (400)
tooManyPromotedItems
invideoPromotion
部分で指定されているプロモート アイテムの数が許容数を超えている場合、channels.update
メソッドはこのエラーを返します。forbidden (403)
promotedVideoNotAllowed
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 日
この改訂での変更内容は次のとおりです。
-
YouTube Data API、v3 には、YouTube API 利用規約に記載されているサポート終了ポリシーが適用されるようになりました。なお、サポート終了予定に関するポリシーの対象となる API の一覧を記載したページでは、v3 API の一部の機能がポリシーの対象から明確に除外されています。
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
プロパティは、更新された動画または新しくアップロードされた動画をその動画カテゴリに関連付けることができるかどうかを示します。 -
次のメソッドのコードサンプルが追加されました。
activities.insert
(Go)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(Go)search.list
(Go)thumbnails.set
(Java)videos.insert
(Go)
2013 年 10 月 24 日
この改訂での変更内容は次のとおりです。
-
この API には、ライブ配信コンテンツの検索と表示に役立つ機能が 2 つ追加されています。
検索結果の新しい
snippet.liveBroadcastContent
プロパティは、動画リソースまたはチャンネル リソースにライブ配信コンテンツが含まれているかどうかを示します。有効な値はupcoming
、active
、none
です。-
video
リソースの新しいsnippet.liveBroadcastContent
プロパティは、動画が今後配信中か、実施中のライブ配信かを示します。このプロパティで使用できる値は次のとおりです。upcoming
– まだ開始されていないライブ配信の動画です。active
– 動画は進行中のライブ配信です。none
– この動画は近日公開予定の、または現在実施中のライブ配信ではありません。これは、YouTube で引き続き視聴可能な、完了したブロードキャストのプロパティ値です。
-
video
リソースの新しいliveStreamingDetails
プロパティは、ライブ動画ブロードキャストに関するメタデータを含むオブジェクトです。このメタデータを取得するには、part
パラメータ値のリソース パーツのリストにliveStreamingDetails
を含めます。メタデータには次の新しいプロパティが含まれています。liveStreamingDetails.actualStartTime
– ブロードキャストが実際に開始された時刻。(この値は、ブロードキャストの状態がactive
になると存在します)。liveStreamingDetails.actualEndTime
– 配信が実際に終了した時刻。(この値はブロードキャストが終了すると表示されます)。liveStreamingDetails.scheduledStartTime
– ブロードキャストの開始が予定されている時刻。liveStreamingDetails.scheduledEndTime
– ブロードキャストの終了が予定されている時刻。プロパティ値が空の場合、またはプロパティが存在しない場合、ブロードキャストは無期限に行われるようにスケジュールされます。liveStreamingDetails.concurrentViewers
– ライブ配信を視聴するユーザーの数。
このメタデータを取得するには、
videos.list
、videos.insert
、またはvideos.update
メソッドを呼び出すときに、part
パラメータ値にliveStreamingDetails
を含めます。
ライブ配信コンテンツを識別するための他の 2 つの機能が、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.insert
、playlists.update
、playlists.delete
の各メソッドがonBehalfOfContentOwner
パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。 -
playlists.insert
メソッドがonBehalfOfContentOwnerChannel
パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。 -
video
リソースのcontentDetails.contentRating.tvpgRating
プロパティで、TV-14
の評価に対応するpg14
の値がサポートされるようになりました。 -
検索結果の一部である
snippet.liveBroadcastContent
プロパティの定義を修正しました。live
は有効なプロパティ値であるがactive
は有効なプロパティ値ではないことが反映されるよう修正されました。 -
video
リソースのcontentDetails.contentRating.mibacRating
プロパティが、次の 2 つの追加評価をサポートするようになりました。mibacVap
(VAP)– お子様は大人の同伴が必要です。mibacVm6
(V.M.6)- 6 歳以上に制限されます。mibacVm12
(V.M.12)– 12 歳以上に制限されます。
-
channel
リソースの新しいinvideoPromotion.items[].promotedByContentOwner
プロパティは、プロモーションの表示時にコンテンツ所有者の名前を表示するかどうかを示します。このフィールドを設定できるのは、値を設定する API リクエストがコンテンツ所有者に代わって行われている場合のみです。詳細については、onBehalfOfContentOwner
パラメータをご覧ください。
2013 年 10 月 1 日
この改訂での変更内容は次のとおりです。
-
channel
リソースの新しいauditDetails
オブジェクトには、マルチチャンネル ネットワーク(MCN)が特定のチャンネルを承認するかどうかを判断する際に評価するチャンネル データが含まれています。このリソース部分を取得する API リクエストは、https://www.googleapis.com/auth/youtubepartner-channel-audit
スコープを含む認証トークンを提供する必要があります。また、MCN がチャンネルを承認または拒否した場合、またはトークン発行日から 2 週間以内に、そのスコープを使用するトークンを取り消す必要があります。 -
channel
リソースのinvideoPromotion.items[].id.type
プロパティで値recentUpload
がサポートされるようになりました。これは、プロモートされたアイテムが、指定されたチャンネルから最近アップロードされた動画であることを示します。デフォルトでは、チャンネルは動画内プロモーション データが設定されているチャンネルと同じになります。ただし、新しい
invideoPromotion.items[].id.recentlyUploadedBy
プロパティの値をそのチャンネルのチャンネル ID に設定することで、別のチャンネルから最近アップロードされた動画をプロモートできます。 -
channel
リソースには、brandingSettings.image.bannerTvLowImageUrl
、brandingSettings.image.bannerTvMediumImageUrl
、brandingSettings.image.bannerTvHighImageUrl
の 3 つの新しいプロパティが含まれています。このプロパティは、テレビアプリのチャンネル ページに表示されるバナー画像の URL を指定します。 -
検索結果の新しい
snippet.liveBroadcastContent
プロパティは、動画リソースまたはチャンネル リソースにライブ配信コンテンツが含まれているかどうかを示します。有効な値はupcoming
、active
、none
です。video
リソースの場合、値upcoming
は動画がまだ開始されていないライブ配信であることを示し、値active
は動画が進行中のライブ配信であることを示します。channel
リソースの場合、値upcoming
はチャンネルにまだ開始されていないスケジュール設定されたブロードキャストがあることを示し、値acive
はチャンネルで進行中のライブ配信があることを示します。
-
watermark
リソースで、targetChannelId
プロパティがオブジェクトから文字列に変更されました。透かし画像がリンクしているチャンネルの YouTube チャンネル ID を指定する子プロパティを格納する代わりに、targetChannelId
プロパティにその値自体を指定するようになりました。そのため、リソースのtargetChannelId.value
プロパティが削除されました。 -
thumbnails.set
メソッドがonBehalfOfContentOwner
パラメータをサポートするようになりました。このパラメータは、他のいくつかのメソッドですでにサポートされています。 -
search.list
メソッドがeventType
パラメータをサポートするようになりました。これにより、有効なブロードキャスト イベント、今後のブロードキャスト イベント、または完了したブロードキャスト イベントのみを返すように検索を制限できます。 -
新しい
contentDetails.contentRating.mibacRating
プロパティは、イタリアの Ministero dei Beni e delle Attivita Culturali e del Turismo から動画に対して付けられた評価を識別します。 -
API で次のエラーがサポートされるようになりました。
エラーのタイプ エラーの詳細 説明 badRequest
invalidImage
thumbnails.set
メソッドは、指定された画像コンテンツが無効な場合、このエラーを返します。forbidden
videoRatingDisabled
videos.rate
メソッドは、評価対象の動画の所有者がその動画の評価を無効にしている場合に、このエラーを返します。
2013 年 8 月 27 日
この改訂での変更内容は次のとおりです。
-
新しい
watermark
リソースは、指定したチャンネルの動画の再生中に表示される画像を識別します。画像のリンク先ターゲット チャンネルや、動画の再生中に透かしを表示するタイミングとその長さを指定することもできます。watermarks.set
メソッドは、チャンネルの透かし画像をアップロードして設定します。watermarks.unset
メソッドは、チャンネルの透かし画像を削除します。エラー ドキュメントには、特に
watermarks.set
メソッドとwatermarks.unset
メソッド向けに API がサポートするエラー メッセージが記載されています。 -
channel
リソースの新しいstatistics.hiddenSubscriberCount
プロパティには、チャンネルのチャンネル登録者数が非表示かどうかを示すブール値が含まれています。そのため、チャンネル登録者数が一般公開されている場合、プロパティの値はfalse
になります。 -
playlists.list
メソッドがonBehalfOfContentOwner
パラメータとonBehalfOfContentOwnerChannel
パラメータをサポートするようになりました。どちらのパラメーターも、他のいくつかのメソッドですでにサポートされています。 -
videos.list
メソッドがregionCode
パラメータをサポートするようになりました。このパラメータは、グラフを取得するコンテンツ領域を識別します。このパラメータは、chart
パラメータと組み合わせた場合にのみ使用できます。このパラメータの値は ISO 3166-1 alpha-2 の国コードです。 -
error documentation
は、複数の API メソッドで発生する可能性のある、次の新しい一般的なリクエスト エラーを示しています。エラーのタイプ エラーの詳細 説明 forbidden
insufficientPermissions
リクエストに対して指定された OAuth 2.0 トークンに関連付けられたスコープが、リクエストされたデータにアクセスするのに不十分です。
2013 年 8 月 15 日
この改訂での変更内容は次のとおりです。
-
channel
リソースのinvideoPromotion
オブジェクトには、次の新しいプロパティと更新されたプロパティがあります。-
API で、ウェブサイトをプロモート アイテムとして指定できるようになりました。そのためには、
invideoPromotion.items[].id.type
プロパティの値をwebsite
に設定し、新しいinvideoPromotion.items[].id.websiteUrl
プロパティを使用して URL を指定します。また、新しいinvideoPromotion.items[].customMessage
プロパティを使用して、プロモーションに表示するカスタム メッセージを定義します。関連ウェブサイト、販売サイト、ソーシャル ネットワーク サイトなどにリンクできます。コンテンツに対してリンクを有効にする方法について詳しくは、YouTube ヘルプセンターの関連ウェブサイトと販売者サイトの手順をご覧ください。
プロモーション リンクを追加すると、それらのリンクが未承認のサイトへトラフィックをリダイレクトするために使用されることはないこと、およびプロモーション リンクが YouTube の AdWords ポリシー、YouTube 広告ポリシー、YouTube コミュニティ ガイドライン、YouTube 利用規約に準拠することに同意するものとします。
-
動画の再生中にプロモート アイテムを表示するタイミング設定に関連するプロパティが再構成されました。
-
invideoPromotion.timing
オブジェクトがinvideoPromotion.items[].timing
に移動しました。このオブジェクトを使用して、invideoPromotion.items[]
リスト内の各プロモート アイテムのタイミング データをカスタマイズできるようになりました。 -
新しい
invideoPromotion.defaultTiming
オブジェクトでは、プロモーションのデフォルトのタイミング設定を指定します。これらの設定では、チャンネルの動画の再生中にプロモート アイテムが表示されるタイミングを定義します。任意のプロモート アイテムのデフォルトのタイミングは、invideoPromotion.items[].timing
オブジェクトを使用してオーバーライドできます。 -
新しい
invideoPromotion.items[].timing.durationMs
プロパティでは、プロモーションを表示する時間をミリ秒単位で指定します。invideoPromotion.defaultTiming
オブジェクトには、プロモートされたアイテムを表示するデフォルトの時間を指定するdurationMs
フィールドも含まれています。
-
-
invideoPromotion.items[].type
プロパティとinvideoPromotion.items[].videoId
プロパティはどちらもinvideoPromotion.items[].id
オブジェクトに移動しました。
-
-
subscriptions.list
メソッドがonBehalfOfContentOwner
パラメータとonBehalfOfContentOwnerChannel
パラメータをサポートするようになりました。どちらのパラメーターも、他のいくつかのメソッドですでにサポートされています。 -
thumbnails.set
リクエストに対する API レスポンスで、kind
プロパティ値がyoutube#thumbnailListResponse
からyoutube#thumbnailSetResponse
に変更されました。 -
次のメソッドのコードサンプルが追加されました。
channels.update
(Java、Python)playlists.insert
(.NET、PHP)subscriptions.insert
(PHP、Python)thumbnails.set
(PHP、Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java、PHP、Python)
また、
playlistItems.insert
メソッドの Python サンプルも、説明した機能がvideos.rate
メソッドで処理されるようになりました。 -
error documentation
は、次の新しいリクエスト コンテキスト エラーを示します。これは、mine
リクエスト パラメータをサポートするすべての API メソッドで発生する可能性があります。エラーのタイプ エラーの詳細 説明 badRequest
invalidMine
認証されたユーザーが YouTube パートナーであるリクエストでは、 mine
パラメータを使用できません。mine
パラメータを削除するか、onBehalfOfContentOwner
パラメータを削除して YouTube ユーザーとして認証するか、呼び出されたメソッドにonBehalfOfContentOwnerChannel
パラメータ(使用可能な場合)を提供してパートナーのチャンネルの 1 つとして動作する必要があります。
2013 年 8 月 8 日
この改訂での変更内容は次のとおりです。
-
YouTube Data API スタートガイドの割り当て使用量セクションを更新し、動画のアップロードの割り当てコストが約 16,000 ユニットから約 1,600 ユニットに変更したことを反映しました。
2013 年 7 月 30 日
この改訂での変更内容は次のとおりです。
-
channelBanner
リソースで、kind
プロパティの値がyoutube#channelBannerInsertResponse
からyoutube#channelBannerResource
に変更されました。このリソースは、channelBanners.insert
リクエストへのレスポンスとして返されます。 -
channel
リソースの新しいbrandingSettings.channel.profileColor
プロパティは、チャンネルのコンテンツを際立たせる目立つ色を指定します。プロパティ値は、ポンド記号(#
)の後に 6 文字の 16 進文字列を続けます(#2793e6
など)。 -
この API では、チャンネル登録の対象がチャンネルのすべてのアクティビティを対象とするか、新規アップロードのみかを指定できるようになりました。
subscription
リソースの新しいcontentDetails.activityType
プロパティは、サブスクライバーに通知されるアクティビティのタイプを識別します。有効な値はall
とuploads
です。 -
videos.list
メソッドでは、YouTube で特に人気の高い動画のグラフを取得するための新しいパラメータがサポートされています。chart
パラメータは、取得するグラフを識別します。現在サポートされている値はmostPopular
のみです。chart
パラメータはフィルタ パラメータです。つまり、他のフィルタ パラメータ(id
とmyRating
)と同じリクエスト内では使用できません。videoCategoryId
パラメータは、グラフを取得する動画のカテゴリを識別します。このパラメータは、chart
パラメータと組み合わせた場合にのみ使用できます。デフォルトでは、グラフは特定のカテゴリに限定されません。
-
video
リソースの新しいtopicDetails.relevantTopicIds[]
プロパティは、動画またはそのコンテンツに関連する Freebase トピック ID のリストを提供します。これらのトピックのテーマは、動画内で言及または登場する場合があります。 -
video
リソースのrecordingDetails.location.elevation
プロパティの名前をrecordingDetails.location.altitude
に変更し、fileDetails.recordingLocation.location.elevation
プロパティの名前をfileDetails.recordingLocation.location.altitude
に変更しました。 -
video
リソースのcontentDetails.contentRating
オブジェクトは、MPAA レーティングや TVPG レーティングなど、さまざまなレーティング方式で動画が受け取るレーティングを指定します。API では、レーティング システムごとに、動画が評価されていないことを示す評価値がサポートされるようになりました。なお、MPAA レーティングには、「レーティングなし」のレーティングは、映画のカット バージョンが公式のレーティングを受けたノーカット バージョンであることを表すためによく使用されます。 -
video
リソースの新しいcontentDetails.contentRating.ytRating
プロパティは、年齢制限のあるコンテンツを識別します。動画に 18 歳未満のユーザーにとって不適切なコンテンツが含まれていると YouTube が判断した場合、このプロパティの値はytAgeRestricted
になります。プロパティが存在しない場合、またはプロパティ値が空の場合、そのコンテンツは年齢制限ありと見なされていません。 -
channels.list
メソッドのmySubscribers
パラメータが非推奨になりました。subscriptions.list
メソッドとそのmySubscribers
パラメータを使用して、認証されたユーザーのチャンネルの登録者リストを取得します。 -
channelBanners.insert
、channels.update
、videos.getRating
、videos.rate
メソッドがすべてonBehalfOfContentOwner
パラメータをサポートするようになりました。このパラメータは、認証されたユーザーがパラメータ値で指定されたコンテンツ所有者の正式な代理人であることを示します。 -
channels.update
メソッドのドキュメントを更新し、このメソッドを使用してchannel
リソースのbrandingSettings
オブジェクトとその子プロパティを更新できるという事実を反映しました。ドキュメントには、channel
リソースのinvideoPromotion
オブジェクトに対して設定できるプロパティの最新リストも記載されています。 -
error documentation
は、次の新しいエラーを示しています。エラーのタイプ エラーの詳細 説明 forbidden
accountDelegationForbidden
このエラーは、特定の API メソッドに固有のエラーではありません。これは、認証済みのユーザーに、指定した Google アカウントの代理権限がないことを示します。 forbidden
authenticatedUserAccountClosed
このエラーは、特定の API メソッドに固有のエラーではありません。これは、認証されたユーザーの YouTube アカウントが閉鎖されていることを示します。ユーザーが別の Google アカウントに代わって操作している場合、このエラーは他のアカウントが閉鎖されていることを示します。 forbidden
authenticatedUserAccountSuspended
このエラーは、特定の API メソッドに固有のエラーではありません。これは、認証されたユーザーの YouTube アカウントが停止されていることを示します。ユーザーが別の Google アカウントに代わって操作している場合、このエラーは他のアカウントが停止されていることを示します。 forbidden
authenticatedUserNotChannel
このエラーは、特定の API メソッドに固有のエラーではありません。これは、API サーバーが API リクエストに関連付けられたチャネルを特定できないことを示します。リクエストが承認され、 onBehalfOfContentOwner
パラメータを使用している場合は、onBehalfOfContentOwnerChannel
パラメータも設定する必要があります。forbidden
cmsUserAccountNotFound
このエラーは、特定の API メソッドに固有のエラーではありません。その CMS ユーザーは、指定されたコンテンツの所有者に代わって操作を実行することを許可されていません。 notFound
contentOwnerAccountNotFound
このエラーは、特定の API メソッドに固有のエラーではありません。指定されたコンテンツの所有者アカウントが見つかりませんでした。 badRequest
invalidPart
このエラーは、特定の API メソッドに固有のエラーではありません。リクエストの part
パラメータが、同時に書き込めない部分を指定しています。badRequest
videoChartNotFound
videos.list
メソッドは、リクエストでサポートされていない、または利用できない動画グラフが指定された場合に、このエラーを返します。notFound
videoNotFound
videos.update
メソッドはこのエラーを返し、更新しようとしている動画が見つからないことを示します。リクエストの本文のid
プロパティの値が正しいことを確認してください。
2013 年 6 月 10 日
この改訂での変更内容は次のとおりです。
-
channels.list
メソッドの新しいforUsername
パラメータを使用すると、YouTube ユーザー名を指定してチャンネルに関する情報を取得できます。 -
activities.list
メソッドがregionCode
パラメータをサポートするようになりました。このパラメータは、指定された国に関連する結果を返すように API に指示します。承認されたユーザーがこれまでに YouTube で行ったアクティビティでは、アクティビティ フィードを生成するのに不十分な場合、YouTube はこの値を使用します。 -
再生リストリソースに
snippet.tags
プロパティが追加されました。プロパティは、自分のプレイリストに関するデータを取得している承認済みユーザーにのみ返されます。承認されたユーザーは、playlists.insert
またはplaylists.update
メソッドを呼び出すときにプレイリストタグを設定することもできます。 -
onBehalfOfContentOwner
パラメータは、これまでchannels.list
メソッドとsearch.list
メソッドでサポートされていましたが、videos.insert
、videos.update
、videos.delete
メソッドでもサポートされるようになりました。なお、このパラメータをvideos.insert
メソッドの呼び出しで使用する場合は、動画を追加するチャンネルを識別する新しいonBehalfOfContentOwnerChannel
パラメータの値もリクエストで指定する必要があります。このチャンネルは、onBehalfOfContentOwner
パラメータで指定されたコンテンツ所有者にリンクしている必要があります。このパラメータは、リクエストの認証情報が、パラメータ値で指定されたコンテンツ所有者の代理人である YouTube CMS ユーザーを識別することを示します。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。
このパラメータは、さまざまな YouTube チャンネルを所有、管理しているコンテンツ パートナーを対象としています。このパラメータを使用すると、パートナーは一度認証すれば、チャンネルごとに認証情報を提供しなくても、動画やチャンネルのすべてのデータにアクセスできます。
このリリースでは、パラメータを使用して、所有する任意の YouTube チャンネルで動画を挿入、更新、削除できるようになりました。
-
error documentation
は、次の新しいエラーを示しています。エラーのタイプ エラーの詳細 説明 forbidden
insufficientCapabilities
このエラーは、特定の API メソッドに固有のエラーではありません。これは、API を呼び出している CMS ユーザーに、リクエストされたオペレーションの実行に必要な権限がないことを示します。このエラーは、複数の API メソッドでサポートされている onBehalfOfContentOwner
パラメータの使用に関連しています。unauthorized
authorizationRequired
activities.list
メソッドは、リクエストでhome
パラメータを使用しているものの、適切に認証されていない場合にこのエラーを返します。 -
channels
リソースでは、チャネル ID がリソースのid
プロパティを使用してすでに指定されているため、invideoPromotion.channelId
プロパティが削除されました。 -
新しいチャンネル ID の使用ガイドでは、API でチャンネル ID がどのように使用されるかについて説明しています。このガイドは、以前のバージョンの API から移行するデベロッパーや、
default
ユーザーのコンテンツをリクエストするアプリケーションや、すべての YouTube チャンネルが一意のユーザー名を持つという概念に依存しているアプリケーションを使用するデベロッパーにとって特に有用です。
2013 年 5 月 22 日
この改訂での変更内容は次のとおりです。
-
新しい
channelBanners.insert
メソッドを使用すると、バナー画像をアップロードできます。この画像は、channel
リソースの新しいbrandingSettings.image.bannerExternalUrl
プロパティを使用して、チャンネルのバナー画像として設定することができます。 -
channels.update
メソッドのドキュメントが更新され、メソッドを呼び出すときに変更できるプロパティがリストされるようになりました。 -
video
リソース ドキュメントで、suggestions.processingErrors[]
、suggestions.processingHints[]
、suggestions.processingWarnings[]
、suggestions.editorSuggestions[]
の各プロパティの有効なプロパティ値としてunspecified
が記載されなくなりました。 -
videos.list
メソッドのmaxResults
パラメータのデフォルト値が5
になりました。 -
error documentation
がchannelBanners.insert
メソッドとsubscriptions.list
メソッドのエラーをリストするようになりました。また、channels.update
メソッドに関する新しいエラーもいくつか示しています。
2013 年 5 月 14 日
この改訂での変更内容は次のとおりです。
-
Python のコードサンプルのリストページには、チャンネル登録の追加、再生リストの作成、動画の更新の例が追加されました。
2013 年 5 月 10 日
この改訂での変更内容は次のとおりです。
-
YouTube では、試験的な API の機能とサービスを識別しなくなりました。代わりに、サポート終了予定ポリシーの対象となる YouTube API のリストを提供しています。
2013 年 5 月 8 日
この改訂での変更内容は次のとおりです。
-
チャンネル リソースが
inVideoPromotion
オブジェクトをサポートするようになりました。このオブジェクトは、チャンネルに関連付けられたプロモーション キャンペーンに関する情報をカプセル化します。動画内プロモーション キャンペーンを使用して、チャンネルの動画の再生中に動画プレーヤー内にプロモート動画のサムネイル画像を表示できます。このデータを取得するには、
channels.list
リクエストのpart
パラメータ値にinvideoPromotion
を含めます。 -
新しい
channels.update
メソッドを使用すると、チャンネルの動画内プロモーション キャンペーン データを更新できます。このメソッドがサポートしているのはchannel
リソースのinvideoPromotion
部分の更新のみで、リソースの他の部分の更新はまだサポートしていません。
2013 年 5 月 2 日
この改訂での変更内容は次のとおりです。
-
チャンネル リソースで
status.isLinked
プロパティがサポートされるようになりました。このプロパティは、YouTube ユーザー名または Google+ アカウントにすでにリンクされているユーザーがチャンネル データによって識別されているかどうかを示します。このいずれかのリンクを持つユーザーは公開されている YouTube ID を既に持っているユーザーであり、動画のアップロードなど、いくつかの操作の前提条件となります。 -
サブスクリプション リソースが
subscriberSnippet
部分をサポートするようになりました。このオブジェクトには、チャンネル登録者のチャンネルのスニペット データが含まれます。 -
API で
videos.getRating
メソッドがサポートされるようになりました。このメソッドは、認証されたユーザーが 1 つ以上の動画のリストに対して付けた評価を取得します。 -
videos.list
メソッドの新しいmyRating
パラメータを使用すると、認証されたユーザーがlike
またはdislike
と評価した動画のリストを取得できます。myRating
パラメータとid
パラメータはどちらもフィルタ パラメータと見なされるようになりました。つまり、API リクエストでどちらか一方のパラメータのみを指定する必要があります。(以前は、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
に設定すると、カメラの動きによるブレを除去して動画を調整できるようになります。
-
次のリソースの
snippet
にchannelTitle
プロパティが追加されました。playlistItem
– 再生リスト アイテムを追加したチャンネルの名前を指定します。playlist
– 再生リストを作成したチャンネルの名前を指定します。subscription
– このプロパティには、登録先のチャンネルの名前を指定します。
-
次のメソッドのコードサンプルが追加されました。
activities.insert
(Ruby)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java、Ruby)videos.insert
(.NET、Ruby)
-
subscriptions.list
メソッドの新しいmySubscribers
パラメータを使用すると、現在認証されているユーザーのサブスクライバーのリストを取得できます。このパラメータは、適切に承認されたリクエストでのみ使用できます。注: この機能は、
channels.list
メソッドで現在サポートされているmySubscribers
パラメータに代わることを目的としています。このパラメータは廃止される予定です。 -
video
リソースで、プロパティ値unspecified
は次のいずれかのプロパティに指定できなくなりました。 -
予期しないパラメータを含む API リクエストで
badRequest
エラーが返されるようになりました。エラーの理由はunexpectedParameter
が報告されています。 -
プレイリストに許可される最大アイテム数がすでに更新されている場合に、
playlistItems.insert
メソッドから返されるエラー。このエラーはforbidden
エラーとして報告されます。エラーの理由はplaylistContainsMaximumNumberOfVideos
です。
2013 年 4 月 19 日
この改訂での変更内容は次のとおりです。
-
新しい
videos.rate
メソッドを使用すると、ユーザーは動画にlike
またはdislike
評価を設定したり、動画から評価を削除したりできます。エラー ドキュメントも更新され、
videos.rate
メソッド呼び出しに対して API から返されるエラーがリストアップされています。 -
サムネイル画像は、API ドキュメントでは個別のリソースとして識別されるようになりました。また、新しい
thumbnails.set
メソッドを使用すると、カスタムの動画サムネイルを YouTube にアップロードして、動画に設定できます。エラー ドキュメントも更新され、
thumbnails.set
メソッド呼び出しに対して API から返されるエラーがリストアップされています。なお、この変更はサムネイル画像を返す既存のリソースには影響しません。これらのリソースでは、以前と同じようにサムネイル画像が返されますが、ドキュメントには API から返される可能性のあるサムネイル サイズの名前の一覧が記載されるようになりました。
-
channel
リソースの新しいbrandingSettings
部分は、チャンネルのチャンネル ページと動画再生ページの設定、テキスト、画像を識別します。 -
playlistItem
リソースには、次の新しいプロパティが含まれています。-
新しい
status
オブジェクトはプレイリスト アイテムに関するステータス情報をカプセル化し、status.privacyStatus
プロパティはプレイリスト アイテムのプライバシー ステータスを識別します。
-
-
video
リソースには、次の新しいプロパティが含まれています。-
status.publicStatsViewable
プロパティは、動画再生ページの拡張動画統計情報を一般公開するかどうかを示します。デフォルトでは、これらの統計情報は閲覧可能です。また、このプロパティの値がfalse
に設定されていても、動画の再生回数や評価などの統計情報は引き続き一般公開されます。このプロパティの値は、videos.insert
メソッドまたはvideos.update
メソッドを呼び出すときに設定できます。 -
contentDetails.contentRating
オブジェクトは、さまざまな評価スキームで動画が受けた評価をカプセル化します。下記の一覧に、サポートされているレーティング システムの一覧と、各レーティング システムに関連付けられている宿泊施設へのリンクを記載しています。プロパティ定義では、各システムでサポートされている評価値を指定します。国 レーティング システム プロパティ 米国 アメリカ映画協会(MPAA) contentDetails.contentRating.mpaaRating
米国 テレビのペアレンタル ガイドライン contentDetails.contentRating.tvpgRating
オーストラリア Australian Classification Board(ACB) contentDetails.contentRating.acbRating
ブラジル Departamento de Justiça、Classificação、Qualificação e Títulos contentDetails.contentRating.djctqRating
カナダ Canadian Home Video Rating System(CHVRS) contentDetails.contentRating.chvrsRating
フランス Centre National du cinéma et de l'image animée(フランス文化省) contentDetails.contentRating.fmocRating
ドイツ Freiwillige Selbstkontrolle der Filmwirtschaft(FSK) contentDetails.contentRating.fskRating
イギリス British Board of Film Classification(BBFC) contentDetails.contentRating.bbfcRating
インド Central Board of Film Certification(CBFC) contentDetails.contentRating.cbfcRating
日本 映画倫理委員会(映倫) contentDetails.contentRating.eirinRating
韓国 タイプ contentDetails.contentRating.kmrbRating
メキシコ ラジオ、テレビ、映画撮影総局(RTC) contentDetails.contentRating.rtcRating
ニュージーランド 映画・文学分類局 contentDetails.contentRating.oflcRating
ロシア ロシア連邦国立映画登録機構 contentDetails.contentRating.russiaRating
スペイン Instituto de la Cinematografía y de las Artes Audiovisuales(ICAA) contentDetails.contentRating.icaaRating
-
-
playlistItems.update
メソッドのドキュメントを更新し、リクエスト本文として送信されるリソースにsnippet.resourceId
プロパティを指定する必要があるという事実を反映しました。 -
search.list
メソッドが次の機能をサポートするようになりました。-
新しい
forMine
パラメータを使用すると、検索対象を認証されたユーザーの動画のみに制限できます。 -
order
パラメータで、結果をタイトルのアルファベット順(order=title
)または動画の件数の降順(order=videoCount
)で並べ替えることができるようになりました。 -
新しい
safeSearch
パラメータは、制限されたコンテンツを検索結果に含めるかどうかを示します。
-
-
videos.insert
メソッドは、次の表に示す新しいエラーをサポートしています。エラーのタイプ エラーの詳細 説明 badRequest
invalidCategoryId
snippet.categoryId
プロパティに無効なカテゴリ ID が指定されています。videoCategories.list
メソッドを使用して、サポートされているカテゴリを取得します。badRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
リクエスト メタデータで指定されたビデオ ゲームの評価は無効です。 badRequest
invalidVideoMetadata
リクエスト メタデータが無効です。 -
onBehalfOfContentOwner
パラメータは、videos.update
メソッドとvideos.delete
メソッドでサポートされているパラメータのリストから削除されました。
2013 年 3 月 12 日
この改訂での変更内容は次のとおりです。
-
次のリソースの
snippet
にchannelTitle
プロパティが追加されました。 -
search.list
メソッドは、次の新しいパラメータをサポートしています。-
channelType
パラメータを使用すると、すべてのチャンネルまたは番組のみを取得するように、チャンネルの検索を制限できます。 -
videoType
パラメータを使用すると、動画の検索対象を制限して、すべての動画、または映画のみ、または番組のエピソードのみを取得できます。
-
-
video
リソースのrecordingDetails
部分の定義を更新し、動画の位置情報または録画時間が設定されている場合のみ、動画に対してオブジェクトが返されるようにしました。 -
playlistItems.update
メソッドがinvalidSnippet
エラーを返すようになりました。これは、API リクエストに有効なスニペットが指定されていない場合に返されます。 -
いくつかの API メソッドでは、YouTube コンテンツ パートナー専用の新しいパラメータがサポートされています。YouTube コンテンツ パートナーには、映画やテレビのスタジオ、レコード レーベル、YouTube でコンテンツを提供しているその他のコンテンツ クリエイターが含まれます。
-
onBehalfOfContentOwner
パラメータは、リクエストの認証情報が、パラメータ値で指定されたコンテンツ所有者の代理人である YouTube CMS ユーザーを識別することを示します。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。このパラメータは、さまざまな YouTube チャンネルを所有、管理しているコンテンツ パートナーを対象としています。このパラメータを使用すると、パートナーは一度認証すれば、チャンネルごとに認証情報を提供しなくても、動画やチャンネルのすべてのデータにアクセスできます。
channels.list
、search.list
、videos.delete
、videos.list
、videos.update
の各メソッドは、このパラメータをサポートしています。 -
managedByMe
パラメータはchannels.list
メソッドでサポートされ、onBehalfOfContentOwner
パラメータで指定されたコンテンツ所有者が所有するすべてのチャンネルを返すよう API に指示します。 -
forContentOwner
パラメータはsearch.list
メソッドでサポートされ、onBehalfOfContentOwner
パラメータで指定されたコンテンツ所有者が所有するリソースのみが含まれるように検索結果を制限するよう API に指示します。
-
2013 年 2 月 25 日
この改訂での変更内容は次のとおりです。
-
API では、
video
リソースについて、いくつかの新しいパーツとプロパティがサポートされています。-
fileDetails
、processingDetails
、suggestions
の新しいパーツは、アップロードした動画に関する情報を動画所有者に提供します。このデータは、以下のような動画のアップロードを可能にするアプリケーションに非常に役立ちます。- 処理のステータスと進行状況
- 動画の処理中に発生したエラーやその他の問題
- サムネイル画像を使用できるかどうか
- 動画やメタデータの品質改善に関する提案
- YouTube にアップロードされた元のファイルに関する詳細
これらの部分のすべてを取得できるのは、動画の所有者のみです。以下のリストでは、新しいパートについて簡単に説明しています。
video
リソース ドキュメントでは、各パートに含まれるすべてのプロパティを定義しています。-
fileDetails
オブジェクトには、ファイルの解像度、再生時間、音声コーデックと動画コーデック、ストリームのビットレートなど、YouTube にアップロードされた動画ファイルに関する情報が格納されます。 -
processingProgress
オブジェクトには、アップロードされた動画ファイルの処理における YouTube の進捗状況に関する情報が格納されます。オブジェクトのプロパティは、現在の処理ステータスと、YouTube で動画の処理が終了するまでの残り時間を示します。また、この部分は、ファイルの詳細やサムネイル画像など、さまざまなタイプのデータやコンテンツを動画で利用できるかどうかも示しています。このオブジェクトは、動画をアップロードしたユーザーが、アップロードされた動画ファイルの処理の進行状況を追跡できるように、ポーリングされるように設計されています。
-
suggestions
オブジェクトには、アップロードした動画の品質やメタデータの改善の機会を特定する提案が格納されます。
-
contentDetails
部分には、4 つの新しいプロパティが含まれています。これらのプロパティは、未認証のリクエストで取得できます。dimension
– 動画が 2D と 3D のどちらを利用できるかを示します。definition
– 動画が標準解像度または高解像度のどちらであるかを示します。caption
– 動画で字幕を使用できるかどうかを示します。licensedContent
– YouTube コンテンツ パートナーによって申し立てられたコンテンツが動画に含まれているかどうかを示します。
-
status
部分には、2 つの新しいプロパティが含まれています。動画の所有者は、動画を挿入または更新する際に両方のプロパティの値を設定できます。これらのプロパティは、未認証のリクエストで取得することもできます。embeddable
– 動画を他のウェブサイトに埋め込むことができるかどうかを示します。license
– 動画のライセンスを指定します。有効な値はcreativeCommon
とyoutube
です。
-
-
videos.list
、videos.insert
、videos.update
メソッドのpart
パラメータの定義が更新され、上記で新たに追加された部分と、誤って省略されたrecordingDetails
部分がリストされるようになりました。 -
channel
リソースの新しいcontentDetails.googlePlusUserId
プロパティには、チャンネルに関連付けられている Google+ プロフィール ID を指定します。この値を使用して、Google+ プロフィールへのリンクを生成できます。 -
各サムネイル画像オブジェクトで画像の幅と高さを指定するようになりました。現在、サムネイル画像は
activity
、channel
、playlist
、playlistItem
、search result
、subscription
、video
の各リソースで返されます。 -
playlistItems.list
がvideoId
パラメータをサポートするようになりました。このパラメータをplaylistId
パラメータと組み合わせて使用すると、指定した動画を表す再生リストアイテムのみを取得できます。このパラメータによって識別される動画が再生リストにない場合、API は
notFound
エラーを返します。 -
エラー ドキュメントには、リクエストされたアクションに対してリクエストが適切に承認されていないことを示す新しい
forbidden
エラーが記載されています。 -
channel
リソースのsnippet.channelId
プロパティが削除されました。リソースのid
プロパティも同じ値を提供します。
2013 年 1 月 30 日
この改訂での変更内容は次のとおりです。
-
新しいエラーページには、API が返す可能性があるエラーが一覧表示されます。このページには、複数の異なる API メソッドで発生する可能性のある一般的なエラーと、メソッド固有のエラーが記載されています。
2013 年 1 月 16 日
この改訂での変更内容は次のとおりです。
-
現在、以下のリストのメソッドと言語のコードサンプルを利用できます。
activities.insert
- JavaplaylistItems.insert
- PythonplaylistItems.list
- Java、JavaScript、PHP、Python、Rubyplaylists.insert
- Java、JavaScript、Pythonsearch.list
- Java、JavaScript、Python、Rubyvideos.insert
- Java
-
activity
リソースがchannelItem
アクションを報告できるようになりました。このアクションは、YouTube が自動生成された YouTube チャンネルに動画を追加したときに発生します。(YouTube では、YouTube ウェブサイト上で注目度の高いトピックをアルゴリズムによって特定し、それらのトピックに対応するチャンネルを自動的に生成します)。 -
次の
search.list
パラメータが更新されました。q
パラメータはフィルタとして指定されなくなりました。つまり、以下のようになります。relatedToVideo
パラメータの名前がrelatedToVideoId
に変更されました。published
パラメータが、publishedAfter
とpublishedBefore
という 2 つの新しいパラメータに置き換えられました。これらについては、以下で説明します。
-
search.list
メソッドは、次の新しいパラメータをサポートしています。パラメータ名 値 説明 channelId
string
指定したチャネルによって作成されたリソースを返します。 publishedAfter
datetime
指定した日時以降に作成されたリソースを返します。 publishedBefore
datetime
指定した時刻より前に作成されたリソースを返します。 regionCode
string
指定した国のリソースを返します。 videoCategoryId
string
指定した動画カテゴリに関連付けられている動画のみが含まれるように、動画の検索結果をフィルタします。 videoEmbeddable
string
動画の検索結果をフィルタして、ウェブページの埋め込みプレーヤーで再生できる動画のみを表示します。埋め込み可能な動画のみを取得するには、パラメータ値を true
に設定します。videoSyndicated
string
YouTube.com の外部で再生できる動画のみが含まれるように動画検索結果をフィルタします。シンジケーション動画のみを取得するには、パラメータ値を true
に設定します。 -
新しいプロパティをサポートする API リソースがいくつかあります。次の表に、リソースと新しいプロパティを示します。
リソース プロパティ名 値 説明 activity
contentDetails.playlistItem.playlistItemId
string
再生リストのアイテムを一意に識別するために YouTube が割り当てた再生リスト アイテム ID。 activity
contentDetails.channelItem
object
チャンネルに追加されたリソースに関する情報を含むオブジェクト。このプロパティは、 snippet.type
がchannelItem
の場合にのみ存在します。activity
contentDetails.channelItem.resourceId
object
チャンネルに追加されたリソースを識別するオブジェクト。他の resourceId
プロパティと同様に、動画や再生リストなどのリソースタイプを指定するkind
プロパティが含まれます。また、そのリソースを一意に識別する ID を指定するvideoId
、playlistId
などのプロパティのうち 1 つのみも含まれます。channel
status
object
このオブジェクトは、チャンネルのプライバシー ステータスに関する情報をカプセル化します。 channel
status.privacyStatus
string
チャンネルのプライバシー ステータス。有効な値は private
とpublic
です。playlist
contentDetails
object
このオブジェクトには、再生リストのコンテンツに関するメタデータが含まれます。 playlist
contentDetails.itemCount
unsigned integer
再生リスト内の動画数。 playlist
player
object
このオブジェクトには、埋め込みプレーヤーで再生リストを再生する際に使用する情報が格納されます。 playlist
player.embedHtml
string
再生リストを再生する動画プレーヤーを埋め込む <iframe>
タグ。video
recordingDetails
object
このオブジェクトは、動画が撮影された場所と時刻を特定または記述する情報をカプセル化します。 video
recordingDetails.location
object
このオブジェクトには、動画に関連付けられた位置情報が含まれています。 video
recordingDetails.location.latitude
double
緯度。 video
recordingDetails.location.longitude
double
経度。 video
recordingDetails.location.elevation
double
地上からの高度(メートル単位)。 video
recordingDetails.locationDescription
string
動画が撮影された場所を説明するテキスト。 video
recordingDetails.recordingDate
datetime
動画が録画された日付と時刻。値は ISO 8601( YYYY-MM-DDThh:mm:ss.sZ
)形式で指定します。 -
いくつかの API メソッドのドキュメントで、リクエストの本文で指定する必要があるプロパティや、リクエスト本文の値に基づいて更新されるプロパティが明記されるようになりました。次の表に、これらのメソッドと、必須プロパティまたは変更可能なプロパティを示します。
注: 他のメソッドのドキュメントには、必須プロパティと変更可能なプロパティがすでに記載されている場合があります。
メソッド プロパティ activities.insert
必須プロパティ: snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
必須プロパティ: id
playlistItems.update
必須プロパティ: id
videos.update
必須プロパティ: id
-
同じチャンネル内にすでに存在する再生リストと同じタイトルの再生リストを作成または更新しようとした場合に、API から
playlistAlreadyExists
エラーが報告されることがなくなりました。 -
いくつかの API メソッドが、新しいエラータイプをサポートしています。このメソッドと、新たにサポートされるエラーを次の表に示します。
メソッド エラーのタイプ エラーの詳細 説明 guideCategories.list
notFound
notFound
id
パラメータで識別されるガイド カテゴリが見つかりません。guideCategories.list メソッドを使用して、有効な値のリストを取得します。playlistItems.delete
forbidden
playlistItemsNotAccessible
リクエストは適切に認証されていないため、指定された再生リスト アイテムを削除できません。 videoCategories.list
notFound
videoCategoryNotFound
id
パラメータで識別される動画カテゴリが見つかりません。videoCategories.list メソッドを使用して、有効な値のリストを取得できます。