一般的なエラー

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

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

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	概要 この演算子は、Ad のサブクラスには使用できません。 一般的な原因 広告の status 以外の属性を変更しようとしている。 対応方法 なし 対策のヒント 一度作成した広告は変更できません。広告を変更する場合は、新しい広告を作成して、古い広告を削除する必要があります。ただし、広告の status は MutateAdGroupAds を使用して変更できます。
INVALID_INPUT	概要 広告のいずれかのフィールドに無効な文字が含まれています。 一般的な原因 URL に特殊文字を使用する。 対応方法 なし 対策のヒント API リクエストを行う前に、アプリで URL を検証します。
LINE_TOO_WIDE	概要 広告のいずれかのフィールドが最大文字数を超えています。テキスト広告についてをご覧ください。 一般的な原因 テキストの行が長すぎる。 対応方法 なし 対策のヒント API リクエストを行う前に、線の長さを検証します。

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	概要 このラベルは、一部の広告にすでに関連付けられています。 一般的な原因 すでに関連付けられている広告にラベルを関連付けようとしている。 対応方法 なし 対策のヒント 追加するラベルが広告にすでに関連付けられているかどうかを最初に確認します。
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	概要 削除した広告を更新しようとしました。 一般的な原因 一度削除した広告は、ステータスの変更を含め、更新できなくなります。 対応方法 なし 対策のヒント 削除した広告をコードで更新しないようにします。

AdGroupCriterionError
INVALID_KEYWORD_TEXT	概要 キーワード テキストに無効な文字が含まれています。キーワードを追加するをご覧ください。 一般的な原因 キーワード テキストに無効な文字が含まれています。 対応方法 なし 対策のヒント API へのリクエストを行う前に、アプリでキーワード テキストを検証します。

AdGroupError
DUPLICATE_ADGROUP_NAME	概要 広告グループの追加または名前変更を行おうとしていますが、名前が他の広告グループですでに使用されています。 一般的な原因 既存の有効な広告グループや一時停止中の広告グループと同じ名前の新しい広告グループを作成しようとしています。 対応方法 エラーを記録し、ユーザーにエラー メッセージを表示します。一意の広告グループ名を提案したり、使用されている名前のリストを表示したりすることもできます。 対策のヒント なし

AssetError
DUPLICATE_ASSET	概要 1 つのリクエスト内の 2 つのオペレーションに、同じバイナリデータを持つアセットの作成オペレーションが含まれている。 一般的な原因 同じバイナリデータを含む重複する作成オペレーションを含む mutate リクエスト。 対応方法 別のリクエストでアセットを作成し、後続のリクエストでそのアセットにリンクするか、同じリクエスト内で一時 ID を使用します。 対策のヒント なし

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 アカウント）でログインしてください。既存の Google 広告アカウントにアクセスする Google アカウントを招待することもできます。クライアント センター（MCC）アカウントにログインし、該当するクライアント アカウントまたは MCC アカウントを選択して Tools and Settings > Access and security に移動し、Google アカウントのメールアドレスを追加します。 対策のヒント なし
OAUTH_TOKEN_INVALID	概要 ヘッダーの OAuth アクセス トークンが無効です。 一般的な原因 HTTP ヘッダーで渡されたアクセス トークンが正しくありません。 対応方法 なし 対策のヒント アカウントに関連付けられた正しいアクセス トークンを渡すようにします。更新トークンや認証コードと混同されることがありますので、ご注意ください。MCC アカウントのすべてのクライアント アカウントにアクセスできる認証情報を取得する場合は、MCC アカウントの更新トークンを取得します。詳しくは、アクセス トークンと更新トークンと OAuth2 のガイドをご覧ください。

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

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	概要 入札単価が、アカウントの通貨の最小単位の整数倍ではありません。たとえば、0.015 米ドル（マイクロ単位で 15000）は有効な入札単価ではありません。 一般的な原因 なし 対応方法 なし 対策のヒント 入札単価がアカウントの通貨の最小単位の倍数になるようにします。
BID_TOO_BIG	概要 入札単価がキャンペーン予算内であっても、このエラーは返されます。 一般的な原因 なし 対応方法 なし 対策のヒント アカウントが Google Ad Grants に参加しているかどうかを確認します。参加している場合は、クリック単価がプログラムで規定されている最大値を超えないようにします。

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	概要 予算額が少なすぎます。 一般的な原因 なし 対応方法 なし 対策のヒント 予算額がアカウントの通貨の最小単位以上になるようにします。
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	概要 予算額をマイクロ単位の金額からアカウントの通貨の金額に換算する際に、小数点以下の有効桁数が多すぎます。 一般的な原因 なし 対応方法 なし 対策のヒント 予算金額がアカウントの通貨の最小単位で割り切れるようにします。

CampaignError
DUPLICATE_CAMPAIGN_NAME	概要 キャンペーンの追加または名前変更を行おうとしていますが、名前が他のキャンペーンですでに使用されています。 一般的な原因 既存の有効なキャンペーンまたは一時停止中のキャンペーンと同じ名前の新しいキャンペーンを作成しようとしています。 対応方法 エラーを記録し、ユーザーにエラー メッセージを表示します。一意のキャンペーン名を提案したり、使用されている名前のリストを表示したりすることもできます。 対策のヒント なし

CriterionError
KEYWORD_HAS_INVALID_CHARS	概要 無効な文字を含むキーワードを追加または編集しています。 一般的な原因 キーワードに ! @ % * などの特殊文字を使用します。 対応方法 なし 対策のヒント 許可されていない文字をキーワードに使わないようにします。キーワードを追加するをご覧ください。

DistinctError
DUPLICATE_ELEMENT	概要 リクエストに含まれている 2 つのパラメータが重複しています。 一般的な原因 なし 対応方法 なし 対策のヒント リクエストを行う前に、重複（オペレーション、パラメータ、リスト要素）を削除します。DistinctElements 制約を持つフィールドを探します。

InternalError
DEADLINE_EXCEEDED	概要 リクエストがタイムアウトし、レスポンスを返すまでに十分な時間内に完了できませんでした。 一般的な原因 検索リクエストが実行され、生成されたレスポンスが大きすぎた、またはミューテーション リクエストが大きすぎて処理できなかった。 対応方法 約 30 秒待ってから、リクエストを再試行します。エラーが解決しない場合は、リクエストを複数の小さなリクエストに分割して、より迅速に完了できるようにします。 対策のヒント セグメンテーションを確認して、セグメンテーションがレスポンスのサイズに与える影響を確認します。gRPC トランスポート レイヤの制限事項に注意してください。
INTERNAL_ERROR	概要 リクエストの処理中に予期しないエラーが発生しました。 一般的な原因 バグが原因で API が正常に機能していません。 対応方法 このエラーで失敗したリクエストは、再試行に指数バックオフ スケジュールを使用して再試行します。 対策のヒント なし
TRANSIENT_ERROR	概要 一時的な内部エラーが発生したため、再試行する必要があります。 一般的な原因 このエラーは、API 内で一時的な問題が発生した場合に発生します。 対応方法 このエラーで失敗したリクエストは、再試行に指数バックオフ スケジュールを使用して再試行します。 対策のヒント なし

InvalidGrantError

invalid_grant (malformed auth code)

概要 OAuth トークンと交換された認証コードの形式が正しくない。 一般的な原因 これは、リクエスト元のアプリケーションへのアクセス権がすでに付与されているユーザーの更新トークンを生成しようとした場合に発生します。たとえば、同じ OAuth クライアント認証情報と承認ユーザーに対して ユーザー認証情報の生成例を複数回実行すると、この問題が発生することがあります。 対応方法 承認ユーザーと OAuth クライアント認証情報の特定の組み合わせのリフレッシュ トークンを再生成するには、既存のリフレッシュ トークンを取り消す必要があります。トークンを取り消すと、そのトークンは Google Ads API へのアクセスに使用できなくなり、更新トークンを使用して生成されたアクセス トークンはすべて無効になります。 対策のヒント 更新トークンを安全な場所に保管し、再生成の必要がないようにしてください。

MutateError
RESOURCE_NOT_FOUND	概要 リクエストで参照されたリソースが見つかりませんでした。 一般的な原因 リクエストで、存在しないリソースまたは削除されたリソースを変更または参照しようとしました。または、リソースに指定されたリソース名の形式が正しくありません。 対応方法 変更リクエストを送信する前に、検索リクエストを使用して既存のリソースのリソース名を取得します。クライアント ライブラリ ガイドを確認します。このガイドには、サポートされているすべての言語で有効なリソース名を作成する方法に関するドキュメントが含まれています。 対策のヒント リソース名を手動で作成しないでください。クライアント ライブラリで提供されているヘルパー メソッドのいずれかを使用します。

NotEmptyError
EMPTY_LIST	概要 必須のリストが空です。 一般的な原因 空のオペレーション リストを mutate メソッドに渡しています。 対応方法 なし 対策のヒント なし

QuotaError
RESOURCE_EXHAUSTED	概要 システムのリクエスト送信頻度の上限を超えました。 一般的な原因 なし 対応方法 なし 対策のヒント リクエスト間に短い遅延を設定するか、複数のオペレーションを組み合わせ、リクエスト回数を減らします。

RangeError
TOO_LOW	概要 値が許可されている下限を下回りました。 一般的な原因 ID の指定を忘れて、0 の値が渡される。 対応方法 なし 対策のヒント API リファレンスに記載されている範囲の制限をご覧ください。

RequestError
INVALID_INPUT	概要 リクエストの形式が正しくありません。 一般的な原因 リクエストの URL またはコンテンツの形式が正しくありません。 対応方法 なし 対策のヒント なし
REQUIRED_FIELD_MISSING	概要 リクエストに必須情報がありません。 一般的な原因 エンティティの追加時に必須フィールドがありません。 対応方法 エラーを記録し、ユーザーにエラー メッセージを表示します。エラーの fieldPath 属性にどのフィールドが欠けているかが示されます。 対策のヒント API リファレンスを参照して必須のフィールドを調べます。

ResourceCountLimitExceededError
RESOURCE_LIMIT	概要 リクエストで、リソースの合計数が指定された上限を超えるリソースの作成が試行されています。 一般的な原因 特定のコンテキストに存在できるリソースの数には複数の上限があります。 対応方法 システムの上限を確認して、発生している上限を特定します。既存のリソースを再利用するか、リソースを削除して新しいリソース用のスペースを作成します。 対策のヒント 検索クエリを使用して、制限のあるリソースの数をモニタリングします。

StringLengthError
TOO_LONG	概要 指定されたフィールドに割り当てられた文字列が上限を超えています。 一般的な原因 広告の広告見出しまたは説明文にテキストが多すぎます。 対応方法 発生している上限を特定し、それに応じて文字列を変更して、リクエストを再送信します。 対策のヒント 文字列の長さの上限に注意してください。