Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。
フィードバックを送信
よくある間違い
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
このガイドでは、一般的な 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 日後に期限切れにならないようにします。
対策のヒント
未確認のアプリ をご覧ください。
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
概要 リクエスト ヘッダーのアクセス トークンが無効か有効期限が切れています。
一般的な原因
アクセス トークンが無効になりました。
対応方法
新しいトークンをリクエスト します。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 アカウントの更新トークンを取得してください。ユーザー認証ガイド をご覧ください。
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(-)を指定します。クライアント ライブラリには、この機能の組み込みサポートが用意されています。
フィードバックを送信
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンス により使用許諾されます。コードサンプルは Apache 2.0 ライセンス により使用許諾されます。詳しくは、Google Developers サイトのポリシー をご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2026-11-13 UTC。
ご意見をお聞かせください
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2026-11-13 UTC。"],[],[]]