一般的なエラー

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

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	概要 トークンが期限切れまたは失効しています。 一般的な原因 外部ユーザータイプ用に 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 アカウント）でログインしてください。クライアント センター（MCC）アカウントにログインし、該当するクライアント アカウントまたはクライアント センター（MCC）アカウントを選択して Tools and Settings > Access and security に移動し、Google アカウントのメールアドレスを追加することで、既存の Google 広告アカウントにアクセスするよう Google アカウントを招待することもできます。 対策のヒント なし
OAUTH_TOKEN_INVALID	概要 ヘッダーの OAuth アクセス トークンが無効です。 一般的な原因 HTTP ヘッダーで渡されたアクセス トークンが正しくありませんでした。 対応方法 なし 対策のヒント アカウントに関連付けられた正しいアクセス トークンを渡すようにします。更新トークンや認証コードと混同されることがありますので、ご注意ください。MCC アカウントのすべてのクライアント アカウントにアクセスできる認証情報を取得する場合は、MCC アカウントの更新トークンを取得します。詳しくは、アクセス トークンと更新トークン、OAuth2 に関するガイドをご覧ください。
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN	概要 デベロッパー トークンはすでに Google Cloud 組織に関連付けられているため、別の組織に関連付けることはできません。 一般的な原因 デベロッパー トークンが、リクエストの送信元となった Google Cloud プロジェクトと同じ Google Cloud 組織内の Google Cloud プロジェクトに関連付けられていない。 対応方法 デベロッパー トークンを使用して API リクエストをすでに作成している場合は、OAuth クライアント ID が同じ Google Cloud 組織内の Google Cloud プロジェクトに関連付けられていることを確認してください。 対策のヒント すべての Google Cloud プロジェクトが同じ Google Cloud 組織に関連付けられていることを確認します。Google Cloud プロジェクトに関連付けることができるデベロッパー トークンは 1 つのみですが、デベロッパー トークンは組織内の複数のプロジェクトに関連付けることができます。
DEVELOPER_TOKEN_INVALID	概要 デベロッパー トークンが無効です。 一般的な原因 このエラーの一般的な原因としては、デベロッパー トークンの入力ミスや、別のリクエスト ヘッダーでデベロッパー トークンが誤って設定されていることが考えられます。 対応方法 API センターからデベロッパー トークンをコピーして、入力ミスを防いでください。API センターは、Google 広告の MCC アカウントで確認できます。また、デベロッパー トークンが正しいヘッダーに設定されていることを確認してください。デベロッパー トークンは、OAuth 更新トークンや認証コードと混同されることがあります。さまざまなリクエスト ヘッダーについて詳しくは、こちらをご覧ください。 対策のヒント なし

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