よくある間違い

このガイドでは、一般的な API エラーの一覧と、それらのエラーを回避して処理するための戦略について説明します。

すべてのエラータイプの包括的なリストについては、Google Ads API エラー リファレンスをご覧ください。さらにサポートが必要な場合は、Google Ads API フォーラムで質問してください。

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 アカウントの更新トークンを取得してください。ユーザー認証ガイドをご覧ください。

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	概要 Google Cloud プロジェクトはテストアクセスのみが可能で、本番環境アカウントへのアクセスには使用できません。 一般的な原因 テスト アクセスレベルの Google Cloud プロジェクトを使用して、テスト以外の（本番環境の）Google 広告アカウントに対してリクエストが行われました。（API バージョン v24 以前では、この条件は AuthorizationError.ACTION_NOT_PERMITTED を返します）。 対応方法 テストを行う場合は、リクエストがテスト アカウントを対象としていることを確認してください。本番環境の Google 広告アカウントにアクセスする場合は、Google Ads API の概要ページで Google Cloud プロジェクトのアクセスレベルを確認し、プロジェクトのアクセスレベルをアップグレードして、Explorer、Basic、標準権限のいずれかのアクセス権を取得してください。 対策のヒント なし
CUSTOMER_NOT_ENABLED	概要 お客様のアカウントは有効な状態ではないため、アクセスできません。 一般的な原因 これは、お客様のアカウントの登録が完了していないか、無効になっている場合に発生します。 対応方法 Google 広告の管理画面にログインし、このアカウントの登録プロセスが完了していることを確認します。無効化されたアカウントについては、利用を停止した Google 広告アカウントを再開するをご覧ください。 対策のヒント お客様のアカウントが利用停止になっているかどうかを事前に確認するには、ステータスが [CANCELLED] になっているかどうかを確認します。
USER_PERMISSION_DENIED	概要 承認された顧客はオペレーティング カスタマへのアクセス権がありません。 一般的な原因 MCC アカウントへのアクセス権を持つユーザーとして認証するが、リクエストで login-customer-id を指定していない。 対応方法 なし 対策のヒント ハイフンなしの MCC アカウント ID（-）として login-customer-id を指定します。クライアント ライブラリには、この機能の組み込みサポートが用意されています。