YouTube APIキーの作成と使用ガイド

「プレイリスト」や「検索」などのフィードタイプに必要な、Google Cloud プロジェクトと YouTube API キーを作成するための手順を順を追って説明します。

YouTube Feedがフィードを最新の状態に保つために必要なYouTube APIキーを設定しますか?

このガイドでは、Google Cloud プロジェクトの作成方法と、YouTube Data API v3 の有効化手順について順を追って説明します。その後、キーを作成し、それをプラグインに追加します。また、Google の 1 日あたりのクォータの仕組みについても解説します。

作業を始める前に、サイトに「YouTube Feed」がインストールされ、有効化されていること、およびGoogleアカウントをお持ちであることを確認してください。

以下が今回の内容です:

注:以下の Google Cloud の手順は、このガイドが最初に作成された時点での Google コンソールの画面を基にしています。Google は随時画面を変更しています。ボタンの位置が若干異なる場合がありますが、手順自体は変わりません。

Google Cloud プロジェクトと API キーの作成

まずは、Googleのデベロッパーコンソールでプロジェクトを設定しましょう。

プレイリスト、検索、ショート、ライブ配信、および単体の動画フィードには、独自のYouTube APIキーが必要です。チャンネルフィードの場合は、代わりに連携済みのYouTubeアカウントを使用することもできます。APIキーを使用することをお勧めします(末尾のFAQを参照してください)。

注意:すでにAPIキーを作成している場合は、APIキーが必要です。

以下のURL(https://console.developers.google.com/projectcreate)を使用して、新しいプロジェクトを作成してください。その後、手順3に進んでください。

作成した新しいプロジェクトが、ページ上部のドロップダウンメニューで選択されている必要があります。

Google Cloudのプロジェクトセレクターが開いており、最近使用したプロジェクトの一覧で、新しく作成されたプロジェクトにチェックが入っています

1)console.developers.google.com/apis にアクセスしてください。Google API サイトを初めて利用する場合は、利用規約への同意を求められます。

利用規約のチェックボックスと「同意して続行」ボタンが表示されたGoogle Cloudのウェルカム画面

2) 「CREATE PROJECT」ボタンをクリックしてプロジェクトを作成します。

「プロジェクトの作成」ボタンが表示された Google Cloud の API およびサービスページ

3) プロジェクトに名前を付けたら、「作成」ボタンをクリックしてください。

Google Cloud の「新しいプロジェクト」フォーム。プロジェクト名が入力され、「作成」ボタンが表示されている。

4) 次に、プロジェクトで YouTube Data API v3 を有効にします。これを行うには、YouTube Data API v3 のページを開き、「有効にする」をクリックします。この手順を行わないと、YouTube によってキーが拒否されます。

Google Cloud の YouTube Data API v3 製品ページ([有効にする] ボタン付き)

5) 「Credentials」ページに移動し、「CREATE CREDENTIALS」をクリックします。このプラグインに必要なキーの種類はAPIキーです。次に、そのオプションを選択してください。

「Google Cloud 認証情報」ページの「認証情報の作成」メニュー(API キーがハイライト表示されている)

6) ポップアップウィンドウに表示されたキーをコピーしてください。次のセクションで必要になります。

Google Cloudで作成されたAPIキーのウィンドウ(キー部分はぼかされています)

キーの準備ができたので、YouTube Feedに追加する準備が整いました。

YouTubeフィードへのAPIキーの追加

Googleからキーが発行されたら、プラグインの「設定」ページでそのキーを追加してください。

7) WordPressの管理画面のサイドバーから、「YouTube Feed」»「設定」に移動します。次に、「一般」タブを開きます。続いて、「APIキー」欄にキーを貼り付けます。その後、「追加」をクリックします。

YouTubeのフィード設定ページの「一般」タブ。APIキー入力欄の横にある「追加」ボタンに矢印が表示されています。

このプラグインは、YouTubeでキーを確認し、それを保存します。YouTubeがキーを受け入れた場合、そのフィールドに緑色のチェックマークが表示されます。YouTubeがキーを受け入れなかった場合、そのフィールドにはエラーマークと、このガイドに戻るリンク付きのメッセージが表示されます。

注:新しいキーが有効になるまで、最大15分ほどかかる場合があります。その時間経過後もフィードにキーに関するエラーメッセージが表示される場合は、当社のエラーメッセージ一覧で各エラーの詳細をご確認ください。

キーが保存されると、そのボタンの表示が「更新」に変わります。キーを置き換えるには、新しいキーを古いキーの上に貼り付けてください。その後、「更新」をクリックしてください。

APIキーが保存されているAPIキー入力欄(ぼかし処理済み)と、「更新」ボタンへの矢印

フィードの作成時にキーを追加する

フィードの作成中にキーを追加することもできます。キーが保存されていない場合、フィードビルダーでは、「Channel」および「Social Wall」を除くすべてのフィードタイプについて、「APIキーが必要です」というウィンドウが表示されます。「Channel」フィードの場合、アカウントが接続されていないときにも、同じウィンドウが表示されます。

チャンネルフィードの場合、ウィンドウにはまずAPIキーまたは連携済みのYouTubeアカウントの選択肢が表示されます。APIキーの方が適しています。連携済みのアカウントでは、非公開、未公開、下書きの動画も表示されてしまいますし、いいねやコメントができない場合があります。ウィンドウにこれらの選択肢が表示されたら、「APIキーを追加(推奨)」をクリックしてください。

フィードビルダーの「APIキーが必要です」ウィンドウ。「APIキーを追加(推奨)」ボタンに矢印が表示されています

次に、そのキーをフィールドに貼り付けてください。その後、「追加」をクリックします。プラグインがキーを保存します。その後、フィードの作成を続行できます。

「APIキーが必要です」というウィンドウには、キー入力欄と、「追加」ボタンの横に矢印が表示されています

これでキーが保存されました。次に、Googleの日次クォータがこれにどのように適用されるかについて説明します。

1日の割り当てはどのように機能するのでしょうか?

Google は、各 Google Cloud プロジェクトに対して、リクエストの 1 日あたりのクォータを設定しています。YouTube Feed がユーザーのキーを使用して YouTube に送信する各リクエストは、そのクォータの一部を消費します。そのプロジェクトのキーを使用するすべてのサイトおよびアプリは、このクォータを共有します。

クォータが上限に達すると、そのキーを使用するフィードは、クォータがリセットされるまで更新が停止します。Google は、太平洋標準時の深夜 0 時に 1 日のクォータをリセットします。Googleのクォータページには、現在の利用可能量と、各リクエストの種類ごとの消費量が一覧表示されています。

YouTube Feedは、各フィードをキャッシュに保存します。ほとんどのページビューでは、YouTubeへのリクエストは一切発生しません。キャッシュ時間を長く設定すれば、リクエストの回数が減ります。当社のエラーメッセージリファレンスには、キャッシュ時間を延長する方法が記載されています。また、1日あたりの制限に達した際のメッセージの表示例も掲載されています。

連携済みのアカウントを削除してもフィードの表示が固まったままの場合は、次のセクションでその解消方法をご説明します。

アカウント変更後にフィードが固まってしまった場合の解消方法

YouTube Feedは、各フィードのキャッシュに保存された設定を使用して、バックグラウンドでフィードを更新します。接続済みのYouTubeアカウントが使用されている間に、フィードがキャッシュされることがあります。その後、そのアカウントが削除された場合、保存された設定の影響で、フィードが空の状態になったり、古い動画のまま表示され続けたりすることがあります。この現象は、有効なキーを追加した後でも続く可能性があります。

次に、「YouTubeフィード」»「設定」に移動します。その後、「フィード」タブを開きます。最後に、「すべてのキャッシュを消去」をクリックします。これにより、各フィードが現在の設定に基づいて再構築されます。次回のバックグラウンド更新では、通常通り保存されます。

[フィード] タブにある「キャッシュ」ボックスで、「すべてのキャッシュをクリア」ボタンに矢印が表示されているもの

これで完了です!これで、YouTube FeedにYouTube APIキーが保存されました。

次に、フィードに動画の代わりにエラーメッセージが表示される場合は、YouTubeフィードのエラーメッセージ一覧をご覧ください。

よくある質問

以下では、YouTube API キーに関するよくある質問のいくつかにお答えします。

注意:APIキーを制限したい場合、...

Google API キーに制限を設けるには、「Web サイトの制限」を使用してください。YouTube Feed はリクエストごとにサイトのアドレスを送信するため、この制限が有効になります。該当のフィールドに、以下の 2 つのエントリを 1 つずつ追加してください。

  • プレフィックスを含むウェブサイトのURL。例: https://example.com
  • www.googleapis.com

APIの制限を設定することもできます。その場合は、「YouTube Data API v3」を選択してください。

APIキーはどこで追加または変更すればよいですか?

キーを追加するには、[YouTubeフィード] » [設定] » [一般] に移動します。次に、[APIキー] フィールドにキーを貼り付け、[追加] をクリックします。すでにキーが保存されている場合は、[更新]をクリックしてください。また、キーが必要なフィードを開始する際にも、フィードビルダーからキーの入力が求められます。

フィードの種類ごとにAPIキーが必要ですか?

フィードビルダーでは、「Channel」および「Social Wall」を除くすべてのフィードタイプについて、キーの入力が求められます。「Channel」フィードは、連携済みのYouTubeアカウントまたはキーを使用して実行できます。

YouTubeアカウントを連携する代わりに、なぜキーを使う必要があるのですか?

YouTubeアカウントを連携すると、非公開、未公開、および下書きの動画も表示されます。また、「いいね」やコメントの閲覧といった機能を利用できない場合があります。このプラグインでは、その両方を回避するためにキーの使用を推奨しています。

APIキーを作成するのに費用はかかりますか?

このプラグインの「APIキーが必要」ウィンドウには、キーの作成は無料で、数分で完了すると記載されています。クォータや制限については、Google側が設定しています。最新の利用規約については、Googleのクォータページをご覧ください。

サポート

ドキュメントに答えが見つからない?

サポート