一般的なエラー

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

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT

概要 OAuth 2.0 アクセス トークンに必要なスコープがありません。 一般的な原因 指定されたアクセス トークンに Google 広告 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 アカウント）でログインしてください。既存の Google 広告アカウントにアクセスする Google アカウントを招待することもできます。クライアント センター（MCC）アカウントにログインし、該当するクライアント アカウントまたは MCC アカウントを選択して Tools and Settings > Access and security に移動し、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 として指定します（-）。クライアント ライブラリには、この機能の組み込みサポートが用意されています。