YouTube Data API v2 の非推奨化: よくある質問

私のアプリケーションは、YouTube Data API v3 に存在しないコメント、キャプション、その他の機能に依存しています。どうすればよいですか？

コメントと動画の字幕のアップロードについては、当面の間 v2 API を引き続きご利用いただけます。この機能はまもなく v3 API に追加される予定です。具体的な日付はまだ決まっていませんが、デベロッパーが v3 に移行するための時間をできるだけ確保できるよう、この機能をリリースする予定です。

その他の機能については、YouTube 全体の進化に伴い、v2 API と v3 API の間で機能の完全な同等性が維持されない場合があります。v3 でサポートされている機能の詳細については、v3 API ドキュメントをご覧ください。

v2 では、ClientLogin を介してメールアドレスとパスワードを使用して認証できます。OAuth 2.0 に移行するにはどうすればよいですか？

ClientLogin から OAuth 2.0 への移行に関するガイドをご覧ください。

v2 と v3 で割り当てはどのように異なりますか？類似点は何ですか？

v2 と v3 の両方で、コストベースの割り当てシステムが使用されています。このシステムでは、一部のオペレーション（アップロードなど）は他のオペレーション（検索など）よりも多くの割り当てを消費します。

v2 システムと v3 システムの最も大きな違いは、v3 にはグローバル割り当てプールがあることです。v2 では、単一のデベロッパー キーで作成されたリクエストが異なる IP アドレスまたは異なる認証済みユーザーから送信された場合でも、そのデベロッパー キーのグローバル割り当てエラーは発生しませんでした。最悪の場合でも、IP アドレスまたは YouTube チャンネルに関連付けられたローカル割り当てエラーが発生するだけでした。

v3 では、グローバル割り当てプール（5,000 万ユニット/日）があり、デベロッパー コンソールの特定のプロジェクトに関連付けられているすべての API 呼び出しで、そのプールから割り当てが減ります。そのため、1 つの IP アドレスまたはチャネルが API 登録に関連付けられた割り当てをすべて消費し、他のユーザーに影響する停止につながる可能性があります。

ただし、1 人のユーザーがグローバル割り当てプールを使い果たすのを防ぐことはできます。この公開ドキュメントでは、より厳格なユーザーごとのレート制限を定義して適用する方法について説明しています。

Data API v2 では、動画検索などの読み取り専用クエリに対して匿名 API アクセスがサポートされていました。v3 で読み取り専用の呼び出しを行うために登録が必要なのはなぜですか？

v3 API は最新の Google API インフラストラクチャ上に構築されており、さまざまな API の使用状況を特定のデベロッパー コンソール登録に関連付けることができます。これにより、デベロッパーは使用している Google テクノロジーを統合的に把握できます。

検索クエリなど、一般公開されているデータにのみアクセスする API 呼び出しの場合、API クライアントは API リクエストを行うときに単純な API キーを指定できます。非公開のユーザーデータにアクセスする API 呼び出しでは、OAuth 2.0 トークンを指定する必要があります。

デベロッパーは、Google Developers Console で シンプルな API キーと OAuth 2.0 トークンの生成に必要な認証情報を取得できます。デベロッパーは、API Explorer を使用して、最初にプロジェクトを作成せずに API をテストすることもできます。

v3 に移行した後も、v2 で使用していたクライアント ライブラリをそのまま使用できますか？

v3 API は v2 と根本的に異なり、使用するクライアント ライブラリの新しいセットがあります。これらはすべて https://developers.google.com/youtube/v3/libraries から入手でき、OAuth 2 認証のネイティブ サポートが含まれています。

以前は v2 の一部である YouTube Insight API を使用していました。他にどのような方法がありますか？

2013 年 9 月に別途非推奨となった YouTube Insight API から、新しい YouTube Analytics API への移行をすべてのデベロッパーにおすすめします。

YouTube 動画の RSS/Atom フィードに GData API（v1 または v2）を使用しています。非推奨になった場合、代替手段はありますか？

現時点では、直接的な代替手段はありません。YouTube Data API v3 の subscriptions サービスのメソッドを使用して、アプリケーションのユーザーが YouTube のチャンネル登録を管理、取得できるようにすることをおすすめします。

v3 ではまだ利用できない v2 の機能も一部使用しているため、同じアプリケーションで両方の API バージョンにアクセスする必要があります。ベスト プラクティスを教えてください。

v3 クライアント ライブラリの OAuth 2.0 サポートを使用して、v2 と v3 の両方の書き込みオペレーションで機能する認証トークンを取得できます。https://gdata.youtube.com または https://www.googleapis.com/auth/youtube スコープのいずれかを持つトークンは、両方の API で機能します。

OAuth 2.0 トークンを必要としない API 呼び出しの場合は、https://cloud.google.com/console から v3 API キーを取得し、v2 と v3 の両方で使用します。

一部の機能で v2 API を呼び出す必要がある場合でも、可能な限り v3 API を使用するようにアプリを移行することをおすすめします。これにより、アプリで v3 が提供するより堅牢な機能を使用できるようになります。また、v3 でサポートされる v2 専用の機能が最終的にリリースされた場合、今後の移行作業が簡素化されます。