よくある間違い

このガイドでは、一般的な 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、Standard アクセスにします。 対策のヒント 該当なし
CUSTOMER_NOT_ENABLED	概要 お客様のアカウントが有効になっていないため、アクセスできません。 一般的な原因 お客様のアカウントの登録が完了していないか、無効になっている場合に発生します。 対応方法 Google 広告の管理画面にログインし、このアカウントの登録プロセスが完了していることを確認します。無効になっているアカウントについては、利用を停止した Google 広告アカウントを再開するをご覧ください。 対策のヒント お客様のアカウントが無効になっているかどうかは、ステータスが CANCELLED であるかどうかを確認することで、事前に確認できます。
USER_PERMISSION_DENIED	概要 承認された顧客はオペレーティング カスタマへのアクセス権がありません。 一般的な原因 MCC アカウントへのアクセス権を持つユーザーとして認証しているが、リクエストで login-customer-id を指定していない。 対応方法 該当なし 対策のヒント login-customer-id をハイフン（-）なしの MCC アカウント ID として指定します。クライアント ライブラリには、この機能の組み込みサポートが用意されています。