よくある間違い

このガイドでは、一般的な API エラーとその防止および処理方法について説明します。

すべてのエラータイプの包括的なリストについては、Google Ads API のエラー リファレンスをご覧ください。ご不明な点がございましたら、サポートにお問い合わせいただくか、Google 広告 Discord サーバーにご参加ください。

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
概要トークンが期限切れまたは失効しています。
一般的な原因 外部ユーザータイプと Testing の公開ステータス用に構成された OAuth 同意画面を含む 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 のクライアント ライブラリのいずれかを使用している場合は、トークンを更新する方法について、そのドキュメントをご覧ください。
対策のヒント アクセス トークンを保存し、有効期限が切れるまで再利用します。
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 プロジェクトのアクセスレベルを確認し、プロジェクトのアクセスレベルをアップグレードして、エクスプローラ、ベーシック、または標準のアクセス権を取得してください。
対策のヒント なし
CUSTOMER_NOT_ENABLED
概要お客様のアカウントは有効な状態ではないため、アクセスできません。
一般的な原因 これは、お客様のアカウントの登録が完了していないか、アカウントが無効になっている場合に発生します。
対応方法 Google 広告の管理画面にログインし、このアカウントの登録プロセスが完了していることを確認します。無効化されたアカウントについては、利用を停止した Google 広告アカウントを再開するをご覧ください。
対策のヒント お客様のアカウントが無効になっているかどうかを事前に確認するには、ステータスが CANCELLED になっているかどうかを確認します。
USER_PERMISSION_DENIED
概要承認された顧客はオペレーティング カスタマへのアクセス権がありません。
一般的な原因 マネージャー アカウントへのアクセス権を持つユーザーとして認証しているが、リクエストで login-customer-id を指定していない。
対応方法 なし
対策のヒント login-customer-id には、ハイフンなしの MCC アカウント ID(-)を指定します。クライアント ライブラリには、この機能の組み込みサポートが用意されています。