この記事の要点

YouTube Data API (v3) の API キーは Google Cloud コンソールで発行する 手順は「プロジェクト作成 → YouTube Data API v3 を有効化 → 認証情報 → API キーを作成」 作成直後にアプリケーションの制限（HTTP リファラー / IP アドレス）と API の制限を付ける API キーで扱えるのは公開データの取得のみ。アップロードや非公開情報の操作には OAuth 2.0 が必要 既定のクォータは 1 日 10,000 ユニット。search.list は 1 回 100 ユニットと重い

API キーでできること・できないこと

YouTube Data API (v3) は、動画・チャンネル・再生リスト・コメントなどの情報をプログラムから取得するための API です。リクエストに付ける認証情報には API キーと OAuth 2.0 の 2 種類があり、用途で使い分けます。

やりたいこと	API キー	OAuth 2.0
公開動画の検索・タイトルや再生回数の取得	可	可
公開チャンネル・再生リストの情報取得	可	可
動画のアップロード・再生リストの編集	不可	可
自分のチャンネルの非公開動画・限定公開の管理	不可	可

「人気動画を一覧表示したい」「チャンネルの最新動画をサイトに載せたい」といった読み取り中心の用途なら、API キーだけで足ります。

API キーの取得手順

Google アカウントでログインした状態で進めます。画面の文言や配置は時期によって変わることがありますが、流れは同じです。

1. Google Cloud コンソール（旧 Google Developers Console）にアクセスします
2. 画面上部のプロジェクト選択から「プロジェクトを作成」（または「新しいプロジェクト」）を押します

3. 任意のプロジェクト名を入力して「作成」を押します。プロジェクト名は後から変更できますが、プロジェクト ID は変更できません

4. 「API とサービス」→「ライブラリ」を開き、「YouTube Data API v3」を検索して「有効にする」を押します。この操作を忘れると、キーを作っても API 呼び出しがエラーになります
5. 「API とサービス」→「認証情報」→「認証情報を作成」→「API キー」の順に押します

6. API キーが作成され、文字列が表示されます。これがリクエストの key パラメータに渡す値です
7. 続けて「キーを制限」（または作成したキーの編集画面）から、使用元と使える API を制限します

キーの制限を必ず設定する

API キーは、知っている人なら誰でも使えてしまう文字列です。漏れると他人にクォータを使い切られるため、作成したら次の 2 種類の制限を設定します。

制限の種類	選ぶ値	向いている使い方
アプリケーションの制限	HTTP リファラー（ウェブサイト）	ブラウザの JavaScript から直接呼ぶ場合。自サイトのドメインを登録
アプリケーションの制限	IP アドレス	サーバー（PHP・Python など）から呼ぶ場合。サーバーのグローバル IP を登録
API の制限	キーを制限 → YouTube Data API v3	どの使い方でも設定推奨。他の API に流用されるのを防ぐ

サーバーから呼ぶのに HTTP リファラー制限を付けると、リファラーが送られないため 403 エラーになります。呼び出し元に合った種類を選んでください。

取得したキーの動作確認

ターミナルから次のように実行し、JSON が返ってくれば成功です。YOUR_API_KEY を発行したキーに置き換えます（動画 ID は任意の公開動画のものを指定）。

curl "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&id=VIDEO_ID&key=YOUR_API_KEY"

返ってきた items の中に、タイトル（snippet.title）や再生回数（statistics.viewCount）が入っています。

クォータ（利用上限）の考え方

YouTube Data API v3 には 1 日あたりのクォータがあり、新規プロジェクトの既定値は 10,000 ユニットです（2026 年時点）。メソッドごとに消費量が決まっていて、videos.list や channels.list は 1 ユニット、search.list は 100 ユニットです。検索を多用すると 1 日 100 回程度で上限に達するため、結果をキャッシュする、検索の代わりにチャンネルのアップロード再生リストを playlistItems.list で取得する、といった工夫が有効です。クォータは太平洋時間の午前 0 時にリセットされます。

よくあるエラーと原因

• 400 API key not valid: キーの文字列が間違っている、またはキーを削除した
• 403 accessNotConfigured: プロジェクトで YouTube Data API v3 が有効化されていない（有効化直後は数分かかることがある）
• 403 quotaExceeded: その日のクォータを使い切った
• 403 の Requests from referer ... are blocked: リファラー制限・IP 制限と呼び出し元が一致していない

キーを安全に扱うために

• キーをソースコードに直接書いて Git に push しない。環境変数や .env ファイルで管理し、.gitignore に入れる
• 漏えいに気づいたら、コンソールでキーを再生成（または削除して新規作成）する
• 可能ならブラウザから直接呼ばず、自分のサーバー経由で呼んでキーを公開しない

関連

• Google OAuth 2.0 認証の実装方法
• OAuth 2.0 認可フロー完全ガイド
• Google Cloud Platform(GCP)とは
• .env ファイル完全ガイド — 環境変数・dotenv・シークレット管理