よくある間違い

このページでは、一般的なエラーの一覧を示し、各エラーの防止と対処のためのヒントを提供しています。エラーの完全なリストについては、エラーの参照をご覧ください。ご不明な点がございましたら、サポートまでお問い合わせください。

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 にする必要があります。詳しくは、スタートガイドをご覧ください。