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

一般的なエラー

このページでは、一般的なエラーの一覧と、その防止と処理のヒントを紹介します。エラーの完全なリストについては、エラーリファレンスをご覧ください。さらにサポートが必要な場合は、フォーラムをご利用ください。

`google.auth.exceptions.RefreshError`

invalid_grant

まとめ	トークンの有効期限が切れているか、取り消されています。
一般的な原因	外部ユーザータイプ用に OAuth 同意画面が構成され、公開ステータスが `Testing` の Google Cloud Platform プロジェクトには、7 日後に期限切れとなる更新トークンが発行されます。
対応方法	Google プロジェクトの公開ステータスは `Testing` であるため、更新トークンは 7 日ごとに期限切れになり、`invalid_grant` エラーが返されます。Google API Console に移動し、OAuth 同意画面に移動します。その後、更新トークンが 7 日後に期限切れにならないよう、次の手順に沿って公開ステータスを `In production` に変更します。
感染予防のヒント	未確認アプリをご覧ください。

CLIENT_CUSTOMER_ID_INVALID

まとめ	クライアントのお客様 ID が数字ではありません。
一般的な原因	不適切なクライアントのお客様 ID を使用している。
対応方法	なし
感染予防のヒント	123-456-7890 は 1234567890 にする必要があります。詳しくは、スタートガイドをご覧ください。

CLIENT_CUSTOMER_ID_IS_REQUIRED

まとめ	クライアントのお客様 ID が HTTP ヘッダーに指定されていませんでした。
一般的な原因	HTTP ヘッダーでクライアントのお客様 ID を指定しない。
対応方法	なし
感染予防のヒント	すべての呼び出しでクライアントのお客様 ID が必要なため、HTTP ヘッダーで指定していることを確認してください。この処理は Google のクライアントライブラリに任せることができます。

CUSTOMER_NOT_FOUND

まとめ	ヘッダーに指定されたお客様 ID に該当するアカウントが見つかりません。
一般的な原因	バックエンドでアカウントが確立される前に作成されたアカウントにアクセスしようとしている。
対応方法	最初の 5 分間待ってから、30 秒ごとに再試行します。
感染予防のヒント	アカウントの作成後、数分待ってから、アカウントに対してリクエストを発行してください。

GOOGLE_ACCOUNT_COOKIE_INVALID

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

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` を指定しません。
対応方法	なし
感染予防のヒント	ハイフン（`-`）なしの MCC アカウント ID として `login-customer-id` を指定します。クライアントライブラリには、この ID のサポートが組み込まれています。