一般的なエラー

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

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 アカウントの更新トークンを取得します。詳しくは、アクセス トークンと更新トークン、OAuth2 に関するガイドをご覧ください。
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 として指定します。クライアント ライブラリには、この機能のサポートが組み込まれています。