YouTube API Quota Exceeded: Causes and Fixes

すべてのGoogle Cloudプロジェクトには、YouTube Data API v3のデフォルトクォータとして1日あたり10,000ユニットが付与されており、太平洋時間の深夜0時にリセットされます - 繰り越しはなく、早期リセットをトリガーする方法もありません。クォータはプロジェクト単位で追跡され、APIキー単位ではありません。そのため、同じプロジェクトから2つ目のキーを生成しても、2つ目のプールが得られるわけではありません。

すべてのAPI呼び出しはリクエスト数ではなくユニット数を消費し、そのコストは均一ではありません。開発者が実際に使用するエンドポイント全体のコストは以下の通りです:

1回の検索につき100ユニットなので、キャプションを1つもダウンロードしないうちに、わずか100回の検索呼び出しだけでプロジェクトの1日のクォータをすべて使い切ってしまうことがあります。これは小規模プロジェクトが上限に達する最も一般的な原因です - 10,000回のリクエストをしたのではなく、数百回の高コストなリクエストをしただけなのです。対照的に、videos.list、channels.list、playlistItems.listはそれぞれ1ユニットと安価です - すでに動画、チャンネル、プレイリストのIDがわかっている場合、これらの呼び出しは日次予算をほとんど消費しません。

1. APIキーが紐づくプロジェクトのGoogle Cloud Consoleを開きます。
2. APIとサービス → YouTube Data API v3 → クォータとシステム上限に移動します。
3. ここには、リアルタイムではなく多少の遅延を伴って更新される、1日あたりのクエリ数と1分あたりの制限に対する現在の使用状況が表示されます。

10,000リクエストに達していないのにすでに上限近くにいる場合、この画面で、これがバグではなく上記の高コスト呼び出しの問題であることを確認できます。

どちらも403を返し、日常会話では両方とも「クォータエラー」とひとくくりにされがちですが、これらは原因も対処法も異なる別の問題です:

• quotaExceeded（理由: dailyLimitExceeded） - プロジェクトが1日の割り当てユニットをすべて使い切った状態です。太平洋時間の深夜0時のリセットを待つか、呼び出しごとのコストを削減するか、クォータ増加の承認を得る以外に解決策はありません。
• rateLimitExceeded - 1日の合計とは関係なく、短い時間枠でリクエストを送りすぎている状態です。これは予算の問題ではなくペースの問題です - 正しいバックオフでの対処法についてはレート制限ガイドをご覧ください。

1. 積極的にキャッシュする。クォータはユーザー向けリクエストごとではなくAPI呼び出しごとに課金されます。同じ動画のキャプションを繰り返し再取得している場合は、分単位で変化しないデータに対してAPIを再度呼び出す代わりに、結果をキャッシュしてください（単純なインメモリのTTLキャッシュでも構いません）。
2. 直接IDルックアップで済む場面ではsearch.listを避ける。すでに動画、チャンネル、プレイリストのIDがある場合、対応する.list呼び出しは検索よりも100倍安価です。
3. IDルックアップをバッチ化する。videos.listは1回の呼び出しで最大50件のカンマ区切りIDを、単一IDと同じ1ユニットのコストで受け付けます - 50本の動画を1本ずつバッチ化せずに取得するのは、理由なく50倍のコストがかかります。
4. 実際の本番利用実績があれば、クォータ増加をリクエストする。Cloud Consoleのクォータページからリンクされている、YouTube API Services Audit and Quota Extensionフォームを使用してください。手動レビューが行われ、即座に承認されるわけではありません。
5. 自分のYouTubeクォータを経由しない文字起こしAPIを使う。GetYouTubeTranscriptのAPIは、お客様のキーでcaptions.downloadをプロキシするのではなく、独自のインフラに対して文字起こしを取得するため、管理すべき1日10,000ユニットの上限はなく、プラン自体のリクエストレート制限のみが適用されます。

cURL:

curl "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ" \
  -H "Authorization: Bearer sk_live_..."

Node.js:

const res = await fetch(
  "https://getyoutubetranscript.com/api/v1/transcript?v=dQw4w9WgXcQ",
  { headers: { Authorization: `Bearer ${process.env.GETYOUTUBETRANSCRIPT_API_KEY}` } }
);
const { data } = await res.json();
console.log(data.transcript);

Python:

import os, requests

res = requests.get(
    "https://getyoutubetranscript.com/api/v1/transcript",
    params={"v": "dQw4w9WgXcQ"},
    headers={"Authorization": f"Bearer {os.environ['GETYOUTUBETRANSCRIPT_API_KEY']}"},
)
print(res.json()["data"]["transcript"])

これはGoogle CloudプロジェクトのYouTube Data APIクォータに対するユニットではなく、GetYouTubeTranscriptプランに対して1クレジットを消費します。ダッシュボードからカード登録不要で100無料クレジットを取得するか、完全なAPIドキュメントをご覧ください。