このページでは、一般的なエラーと、その防止と処理に関するヒントを紹介します。エラーの一覧については、エラー リファレンスをご覧ください。さらにサポートが必要な場合は、フォーラムをご覧ください。
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 を指定します。クライアント ライブラリには、このサポートが組み込まれています。 |
|