エラーコード

HTTP エラーコードの**正式な一覧は英語版のエラーコードリファレンス**です。コードやその返される場面が変わったときは英語版が先に更新されるため、実装の判断には英語版を参照してください。このページは読み方の要点だけをまとめています。

エラーレスポンスの形

API はエラー時に HTTP ステータスコードと、error フィールドに英語のメッセージを含む JSON を返します。

{"error": "project not found"}

コンソールでは、このメッセージがコンソールの表示言語（日本語または英語）で表示されます。プログラムから扱う場合は、メッセージの文言ではなくステータスコードで分岐してください。

分類	対処の考え方
クォータとエンタイトルメント	プランのアップグレードが必要なエラーと、時間をおけば回復するレート制限は別のコードです。レート制限は指数バックオフで再試行します。
認証と認可	クレデンシャルがない・無効な場合と、クレデンシャルは有効でも権限が足りない場合は別のコードです。
クライアントエラー	リクエストの形式や内容、リソースの有無、状態の競合を示します。リクエストを直してから送り直します。
サーバーエラー	サーバー側の障害です。再試行できます。

各コードとそれが返される場面は、英語版のエラーコードリファレンスを参照してください。