YouTube Analytics APIの403は権限ではなくAPI有効化が原因だった

起きたこと：YouTube Analytics APIが403を返す

自分で運用しているツールからYouTube Analytics APIを呼び出したところ、レスポンスが403で返ってきました。認証は通っているのにデータが取れない、という状態です。

返ってきたエラーメッセージには、次の一節が含まれていました。

has not been used in project N

（Nの部分にはプロジェクトの識別子が入ります。）

最初の判断：スコープ不足だと思い込んだ

403という数字を見た瞬間、私は権限（スコープ）の問題だと決めつけました。OAuthのスコープ指定が足りないのだろう、と。これは誤りでした。

認証まわりを疑い始めると、確認すべき箇所が一気に増えます。スコープの文字列、同意画面、トークンの再取得。どれも「怪しく見える」ので、時間だけが溶けていきます。しかも今回は、そのどれも原因ではありませんでした。

実際の原因：プロジェクトでAPIが有効化されていなかった

エラーメッセージの has not been used in project N は、そのまま読めば「このプロジェクトでこのAPIはまだ使われていない」という意味です。権限がどうこうではなく、そもそもGoogle Cloudのそのプロジェクトで YouTube Analytics API が有効化されていなかった、というだけの話でした。

やったこと：コンソールで有効化するだけ

1. エラーメッセージ内のプロジェクト（N）を確認する
2. Google Cloud コンソールでそのプロジェクトを開く
3. YouTube Analytics API を有効化する
4. 再度APIを叩く

作業としては1クリックの有効化で終わりました。その後、同じリクエストがそのまま通りました。コードは一行も変えていません。

今回の教訓

• 403が返ったら、まずレスポンスのメッセージ本文を読む
• has not been used in project が入っていたら、権限ではなくAPI有効化を疑う
• エラーメッセージに書かれているプロジェクトが、自分が想定しているプロジェクトかを確認する

• ステータスコードだけで原因を推定する
• 「403だからスコープだろう」と、認証まわりから調べ始める

分かっていないこと

正直に書いておくと、なぜそのプロジェクトでAPIが有効化されていなかったのか、その経緯までは特定できていません。有効化してリクエストが通ったところで調査を終えているためです。また、権限（スコープ）側の設定が今回のケースで本当に十分だったのかは、有効化によって成功したという事実から逆算しているだけで、個別に検証したわけではありません。

それでも、今回はっきりしたことが一つあります。エラーメッセージは、こちらが読む気になれば原因をそのまま書いてくれているということです。読まずに推測したぶんだけ、遠回りしました。