1. はじめに

YouTube Data APIを使っている開発者にとって、最も恐ろしい言葉。
それは 「Quota Exceeded（利用枠超過）」 です。

YouTube APIには1日あたり10,000ユニットという厳しい制限があります。
これを超えると、翌日までAPIが一切使えなくなり、アプリは機能停止に追い込まれます。

「あとどれくらい使えるんだろう？」
「突然止まったらどうしよう…」

そんな不安を解消するために、「クォータ残量を監視する環境」 を構築しました。
今回は、その第一歩となる 「Google Cloud Monitoring APIのセットアップ手順」 を解説します。

2. 直面した課題：残量を確認する術がない

最初は「APIを叩くたびに消費量を記録すればいいのでは？」と考えました。
しかし、複数のプログラムからAPIを利用している場合、正確な合算値を出すのは困難です。

そこで、Google Cloud Platform (GCP) 自体が持っている監視データ（Cloud Monitoring）に外部からアクセスし、正確な消費量を取得することにしました。
これなら、YouTube APIのクォータを消費せずに、監視データだけを取得できます。

それでは具体的な手順を見ていきましょう。
GCPコンソールでの操作がメインになります。

まず、プロジェクトで監視機能をONにします。

監視プログラム専用の「身分証明書」を作ります。

ここが重要です。余計な権限を与えず、監視だけに絞ります。

ここで一つ、個人開発でも遭遇しやすいトラブルがあります。
「サービスアカウントキー（JSON）を作成しようとしたらエラーになる」という現象です。

これはGCPのセキュリティ強化により、デフォルトで 「キーの作成が無効化」 されている場合があるためです。
以下の手順で解除しました。

「IAM と管理」 > 「組織ポリシー」 を開く。
検索バーに iam.disableServiceAccountKeyCreation と入力。
「サービスアカウントキーの作成を無効にする」 というポリシーを選択。
「ポリシーを管理」 をクリックし、以下のように設定変更します。
- 適用範囲: 「親のポリシーをオーバーライドする」
- ルール: 「オフ（強制なし）」に設定

これで無事にキーが作れるようになります。

最後に、プログラムから使うための認証ファイルをダウンロードします。

⚠ セキュリティ注意: このJSONファイルはパスワードそのものです。GitHubなどに絶対にアップロードしないでください。

注意点としては、正確にデータが取得できるものの、その中身は少し古く、5～15分前時点のデータを参照して結果を出力する、という処理になるみたいです。
なのでリアルタイムで正確に情報を確認したい、と言った場合はほかの手法を考える必要がありそうです。

取得するときに処理としては1. 5秒ぐらいかかるので、並行処理などを織り交ぜながら時間の効率化を図る必要があります。

これで、YouTube APIの利用状況を外部から監視する下準備が整いました。
あとはこのJSONキーを使ってPythonなどのスクリプトからCloud Monitoring APIを叩けば、「現在◯◯%消費中」といったデータを取得できます。

「転ばぬ先の杖」。
API枯渇でサービスが止まる前に、まずは監視環境だけでも整えておくことを強くおすすめします。