このページでは、一般的なエラーの一覧を示し、各エラーの防止と対処のためのヒントを提供しています。エラーの完全なリストについては、エラーの参照をご覧ください。より詳しいサポートが必要な場合は、フォーラムをご覧ください。
google.auth.exceptions.RefreshError
|
invalid_grant |
| 概要 | トークンが期限切れまたは失効しています。 |
|---|
| 一般的な原因 |
外部ユーザータイプ用に OAuth 同意画面が構成され、公開ステータスが Testing の Google Cloud Platform プロジェクトには、7 日間有効な更新トークンが発行されます。
|
|---|
| 対応方法 |
Google プロジェクトの公開ステータスが Testing であるため、更新トークンは 7 日ごとに期限切れになり、invalid_grant エラーが発生します。Google API Console に移動し、OAuth 同意画面に移動します。その後、こちらの手順に沿って公開ステータスを In production に変更し、更新トークンが 7 日以内に期限切れにならないようにします。
|
|---|
| 対策のヒント |
未確認アプリをご覧ください。
|
|---|
|
|
CLIENT_CUSTOMER_ID_INVALID |
| 概要 | クライアントのお客様 ID が数字ではありません。 |
|---|
| 一般的な原因 |
不適切なクライアント カスタマー ID を使用している。
|
|---|
| 対応方法 |
なし
|
|---|
| 対策のヒント |
123-456-7890 は 1234567890 にする必要があります。詳しくは、スタートガイドをご覧ください。 |
|---|
|
CLIENT_CUSTOMER_ID_IS_REQUIRED |
| 概要 | クライアントのお客様 ID が HTTP ヘッダーに指定されていませんでした。 |
|---|
| 一般的な原因 |
HTTP ヘッダーでクライアントのお客様 ID が指定されていない。 |
|---|
| 対応方法 |
なし
|
|---|
| 対策のヒント |
すべての呼び出しでクライアントのお客様 ID が必要となるため、HTTP ヘッダーに指定してください。この処理が用意されているクライアント ライブラリを使うことを検討してください。
|
|---|
|
CUSTOMER_NOT_FOUND |
| 概要 | ヘッダーに指定されたお客様 ID に該当するアカウントが見つかりません。 |
|---|
| 一般的な原因 |
作成されたアカウントがバックエンドに設定される前に、そのアカウントにアクセスしようとしています。
|
|---|
| 対応方法 |
最初に 5 分間待ってから、30 秒ごとに再試行します。
|
|---|
| 対策のヒント |
アカウントが作成されたら、数分待ってからアカウントに対してリクエストを送信します。 |
|---|
|
GOOGLE_ACCOUNT_COOKIE_INVALID |
| 概要 | リクエスト ヘッダーのアクセス トークンが無効か有効期限が切れています。 |
|---|
| 一般的な原因 |
アクセス トークンが無効になっています。
|
|---|
| 対応方法 |
新しいトークンをリクエストします。いずれかのクライアント ライブラリを使用している場合は、トークンを更新する方法について、該当するライブラリのドキュメントをご覧ください。
|
|---|
| 対策のヒント |
アクセス トークンを保存し、有効期限が切れるまで再利用します。 |
|---|
|
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 を指定していません。
|
|---|
| 対応方法 |
なし
|
|---|
| 対策のヒント |
login-customer-id をハイフンなしの MCC アカウント ID として指定します（-）。クライアント ライブラリには、この機能の組み込みサポートが用意されています。
|
|---|
|
