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