このページは Cloud Translation API によって翻訳されました。

一般的なエラー

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

`google.auth.exceptions.RefreshError`

invalid_grant

概要	トークンが期限切れまたは失効しています。
一般的な原因	外部ユーザータイプ用に OAuth 同意画面が構成され、公開ステータスが `Testing` の 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

概要	リクエストヘッダーのアクセストークンが無効か有効期限が切れています。
一般的な原因	アクセストークンが無効になっています。
対応方法	新しいトークンをリクエストします。いずれかのクライアントライブラリを使用している場合は、トークンを更新する方法について、該当するライブラリのドキュメントをご覧ください。
対策のヒント	アクセストークンを保存し、有効期限が切れるまで再利用します。

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 のガイドをご覧ください。

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 として指定します（`-`）。クライアントライブラリには、この機能の組み込みサポートが用意されています。