一般的なエラー

このページでは、一般的なエラーの一覧を示し、各エラーの防止と対処のためのヒントを提供しています。 エラーの完全なリストについては、エラー の参照をご覧ください。より詳しいサポートが必要な場合は、 フォーラムをご覧ください。

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

概要 OAuth 2.0 アクセス トークンに必要なスコープがありません。 一般的な原因 提供されたアクセス トークンに Google Ads API OAuth 2.0 スコープが含まれていないため、リクエストが拒否されます。 対応方法 アクセス トークンに必要なスコープがあることを確認してください。このエラーの一般的な原因は、別の OAuth スコープのセットを使用して生成された既存のアクセス トークンを再利用していることです。必要なスコープで新しいアクセス トークンを生成する方法の例については、OAuth 認証パラメータをご覧ください。 対策のヒント アクセス トークンに必要なスコープがあることを確認します。必要なスコープでユーザーを再認証して、必要なスコープでアクセスを取得します。アプリケーションで複数の OAuth スコープを使用している場合は、詳細な OAuth 権限の実装が必要になることがあります。

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

AuthenticationError
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 アカウント）でログインしてください。また、MCC アカウントにログインし、問題のあるお客様または MCC アカウントを選択して、Tools and Settings > Access and security[ツールと設定] > [アクセスとセキュリティ] に移動し、Google アカウントのメールアドレスを追加することで、Google アカウントを既存の Google 広告アカウントに招待してアクセスできるようにすることもできます。 対策のヒント 該当なし
OAUTH_TOKEN_INVALID	概要 ヘッダーの OAuth アクセス トークンが無効です。 一般的な原因 HTTP ヘッダーで渡されたアクセス トークンが正しくありませんでした。 対応方法 該当なし 対策のヒント アカウントに関連付けられた正しいアクセス トークンを渡すようにします。更新トークンや認証コードと混同されることがありますので、ご注意ください。MCC アカウントのすべてのクライアント アカウントにアクセスできる認証情報を取得する場合は、MCC アカウントの更新トークンを取得します。ユーザー認証ガイドをご覧ください。
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	概要 開発者トークンはすでに Google Cloud 組織に関連付けられており、別の組織に関連付けることはできません。 一般的な原因 開発者トークンが、リクエストの作成に使用された Google Cloud プロジェクトと同じ Google Cloud 組織内の Google Cloud プロジェクトに関連付けられていません。 対応方法 開発者トークンを使用してすでに API リクエストを行っている場合は、OAuth クライアント ID が同じ Google Cloud 組織内の Google Cloud プロジェクトに関連付けられていることを確認してください。 対策のヒント すべての Google Cloud プロジェクトが同じ Google Cloud 組織に関連付けられていることを確認してください。Google Cloud プロジェクトは 1 つの開発者トークンにのみ関連付けることができますが、開発者トークンは組織内の複数のプロジェクトに関連付けることができます。
DEVELOPER_TOKEN_INVALID	概要 開発者トークンが無効です。 一般的な原因 このエラーの一般的な原因としては、開発者トークンのスペルミスや、別のリクエスト ヘッダーに開発者トークンが誤って設定されていることが考えられます。 対応方法 スペルミスを避けるため、API センターから開発者トークンをコピーしてください。API センターは、Google 広告の MCC アカウントにあります。また、正しいヘッダーに開発者トークンを設定していることを確認してください。開発者トークンは、OAuth 更新トークンや認証コードと混同されることがあります。さまざまなリクエスト ヘッダーについて詳しくは、こちらをご覧ください。 対策のヒント 該当なし

AuthorizationError
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 として指定します。クライアント ライブラリには、この機能が組み込まれています。