一般的なエラー

このページでは、一般的なエラーと、その防止と処理に関するヒントを紹介します。エラーの一覧については、エラーリファレンスをご覧ください。さらにサポートが必要な場合は、フォーラムをご覧ください。

`google.auth.exceptions.RefreshError`

invalid_grant

まとめ	トークンの有効期限が切れているか、取り消されています。
一般的な原因	外部ユーザータイプ用に OAuth 同意画面が構成され、公開ステータスが `Testing` の Google Cloud Platform プロジェクトに、7 日後に期限切れになる更新トークンが発行されます。
対応方法	Google プロジェクトの公開ステータスが `Testing` であるため、更新トークンは 7 日ごとに期限切れになり、`invalid_grant` エラーが発生します。Google API Console で、OAuth 同意画面に移動します。次に、更新トークンが 7 日後に期限切れにならないよう、次の手順に沿って公開ステータスを `In production` に変更します。
感染予防のヒント	未確認のアプリをご覧ください。

CLIENT_CUSTOMER_ID_INVALID

まとめ	クライアントのお客様 ID が数字ではありません。
一般的な原因	不適切なクライアントのお客様 ID を使用している。
対応方法	なし
感染予防のヒント	123-456-7890 は 1234567890 にする必要があります。詳しくは、スタートガイドをご覧ください。

CLIENT_CUSTOMER_ID_IS_REQUIRED

まとめ	クライアントのお客様 ID が HTTP ヘッダーに指定されていませんでした。
一般的な原因	HTTP ヘッダーでクライアントのお客様 ID を指定しない。
対応方法	なし
感染予防のヒント	クライアントのお客様 ID はすべての呼び出しで必須であるため、HTTP ヘッダーで必ず ID を指定してください。Google のクライアントライブラリを使用して、この処理を行うことを検討してください。

CUSTOMER_NOT_FOUND

まとめ	ヘッダーに指定されたお客様 ID に該当するアカウントが見つかりません。
一般的な原因	アカウントがバックエンドで確立される前に、作成されたばかりのアカウントにアクセスしようとしています。
対応方法	最初の 5 分待ってから、30 秒ごとに再試行します。
感染予防のヒント	アカウントの作成後、数分待ってから、アカウントに対してリクエストを発行します。

GOOGLE_ACCOUNT_COOKIE_INVALID

まとめ	リクエストヘッダーのアクセストークンが無効か有効期限が切れています。
一般的な原因	アクセストークンが無効になっています。
対応方法	新しいトークンをリクエストします。Google のクライアントライブラリを使用している場合は、トークンの更新方法についてのクライアントライブラリのドキュメントをご覧ください。
感染予防のヒント	期限が切れるまでアクセストークンを保存し、再利用します。

NOT_ADS_USER

まとめ	アクセストークンの生成に使用された Google アカウントが、どの Google 広告アカウントにも関連付けられていない。
一般的な原因	ご提供いただいたログイン情報は、Google 広告が有効になっていない Google アカウントのものです。
対応方法	OAuth フローの対象となる有効な Google 広告アカウント（通常はクライアントセンター（MCC）アカウント）でログインしてください。既存の Google 広告アカウントにアクセスできるように Google アカウントを招待することもできます。そのためには、MCC アカウントにログインし、対象のお客様または MCC アカウントを選択して `Tools and Settings > Access and security` に移動し、Google アカウントのメールアドレスを追加します。
感染予防のヒント	なし

OAUTH_TOKEN_INVALID

まとめ	ヘッダーの OAuth アクセストークンが無効です。
一般的な原因	HTTP ヘッダーで渡されたアクセストークンが正しくありませんでした。
対応方法	なし
感染予防のヒント	アカウントに関連付けられた正しいアクセストークンを渡すようにします。更新トークンや認証コードと混同されることがありますので、ご注意ください。MCC アカウントのすべてのクライアントアカウントにアクセスできる認証情報を取得するには、MCC アカウントの更新トークンを取得します。詳しくは、アクセストークンと更新トークンおよび OAuth2 に関するガイドをご覧ください。

CUSTOMER_NOT_ENABLED

まとめ	お客様のアカウントが有効状態ではないため、アクセスできません。
一般的な原因	これは、お客様のアカウントが登録を完了していないか、無効になった場合に発生します。
対応方法	Google 広告の管理画面にログインし、このアカウントの登録プロセスが完了していることを確認します。無効になったアカウントについては、利用を停止した Google 広告アカウントを再開するをご覧ください。
感染予防のヒント	CANCELLED ステータスを確認することで、お客様のアカウントが無効になっているかどうかを前もって確認できます。

DEVELOPER_TOKEN_NOT_APPROVED

まとめ	開発者トークンがテストアカウントでのみ承認され、テスト以外のアカウントへのアクセスが試行されている。
一般的な原因	テスト用開発者トークンがテスト用でないアカウントへのアクセスに使用された場合。
対応方法	テスト以外のアカウントにアクセスしていることを確認します。その場合は、開発者トークンを標準アクセスまたはベーシックアクセスにアップグレードするための申請を行う必要があります。
感染予防のヒント	なし

DEVELOPER_TOKEN_PROHIBITED

まとめ	リクエストで送信されたプロジェクトで開発者トークンを使用できません。
一般的な原因	開発者トークンは、Google API Console プロジェクトごとに 1 つの MCC アカウントのみに関連付けることができます。Google Ads API リクエストを行うと、開発者トークンは Google API Console プロジェクトと恒久的にペア設定されます。新しい Google API Console プロジェクトを使用していない場合、リクエスト時に `DEVELOPER_TOKEN_PROHIBITED` エラーが発生します。
対応方法	なし
感染予防のヒント	新しい MCC アカウントの開発者トークンに切り替える場合は、新しい MCC アカウントのトークンを使用する Google Ads API リクエスト用に、新しい Google API Console プロジェクトを作成する必要があります。

USER_PERMISSION_DENIED

まとめ	承認された顧客はオペレーティングカスタマへのアクセス権がありません。
一般的な原因	MCC アカウントにアクセスできるユーザーとして認証しているが、リクエストで `login-customer-id` を指定していない。
対応方法	なし
感染予防のヒント	MCC アカウント ID としてハイフン（`-`）なしで `login-customer-id` を指定します。クライアントライブラリには、このサポートが組み込まれています。