Package google.ads.searchads360.v0.errors

インデックス

AuthenticationErrorEnum

この型にはフィールドがありません。

考えられる認証エラーを記述する列挙型のコンテナ。

AuthenticationError

発生する可能性のある認証エラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
AUTHENTICATION_ERROR リクエストの認証に失敗しました。
CLIENT_CUSTOMER_ID_INVALID クライアントのお客様 ID が数字ではありません。
CUSTOMER_NOT_FOUND ご指定のお客様 ID に対応するお客様が見つかりません。
GOOGLE_ACCOUNT_DELETED クライアントの Google アカウントが削除されている。
GOOGLE_ACCOUNT_AUTHENTICATION_FAILED Google アカウントの認証中に問題が発生しました。
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH Google アカウントのログイン トークンのユーザーが、Cookie のユーザー ID と一致しません。
NOT_ADS_USER OAuth アクセス トークンを生成した Google アカウントが検索広告 360 アカウントに関連付けられていない。新しいアカウントを作成するか、Google アカウントを既存の検索広告 360 アカウントに追加します。
OAUTH_TOKEN_INVALID ヘッダー内の OAuth トークンが無効です。
OAUTH_TOKEN_EXPIRED ヘッダーの OAuth トークンの有効期限が切れています。
OAUTH_TOKEN_DISABLED ヘッダー内の OAuth トークンが無効になっています。
OAUTH_TOKEN_REVOKED ヘッダーの OAuth トークンが取り消されています。
OAUTH_TOKEN_HEADER_INVALID OAuth トークンの HTTP ヘッダーの形式が正しくありません。
USER_ID_INVALID ヘッダーのユーザー ID は有効な ID ではありません。
TWO_STEP_VERIFICATION_NOT_ENROLLED このアカウントの認証設定は、アカウント管理者によって変更されました。このアカウントにアクセスするには、https://www.google.com/landing/2step で Google アカウントで 2 段階認証プロセスを有効にしてください。
ADVANCED_PROTECTION_NOT_ENROLLED このアカウントの認証設定は、アカウント管理者によって変更されました。このアカウントにアクセスするには、https://landing.google.com/advancedprotection で Google アカウントの高度な保護機能を有効にしてください。

AuthorizationErrorEnum

この型にはフィールドがありません。

考えられる認可エラーを記述する列挙型のコンテナ。

AuthorizationError

考えられる承認エラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
USER_PERMISSION_DENIED ユーザーには、顧客にアクセスする権限がありません。注: クライアントのお客様にアクセスする場合は、login-customer-id ヘッダーにマネージャーのお客様 ID を設定する必要があります。詳しくは、https://developers.google.com/search-ads/reporting/concepts/call-structure#login_customer_id_header をご覧ください。
PROJECT_DISABLED リクエストで送信された Google Cloud プロジェクトに、API へのアクセス権限がありません。
AUTHORIZATION_ERROR クライアントを承認できませんでした。
ACTION_NOT_PERMITTED ユーザーには、リソースに対してこのアクション（ADD、UPDATE、REMOVE など）を実行する権限や、メソッドを呼び出す権限がありません。
INCOMPLETE_SIGNUP 登録が完了していません。
CUSTOMER_NOT_ENABLED お客様のアカウントはまだ有効になっていないか、無効になっているため、アクセスできません。
MISSING_TOS デベロッパーは利用規約に署名する必要があります。利用規約はこちら（https://developers.google.com/terms）でご確認いただけます。
INVALID_LOGIN_CUSTOMER_ID_SERVING_CUSTOMER_ID_COMBINATION 指定されたログイン カスタマーは指定されたアカウントにアクセスできないため、リクエストは無効です。
SERVICE_ACCESS_DENIED 指定したデベロッパーには、サービスへのアクセス権がありません。
ACCESS_DENIED_FOR_ACCOUNT_TYPE お客様（またはログインしたお客様）が Search Ads 360 API を使用できません。別の広告システムに属している場合。
METRIC_ACCESS_DENIED デベロッパーは、クエリされた指標にアクセスできません。

CustomColumnErrorEnum

この型にはフィールドがありません。

考えられるカスタム列エラーを記述する列挙型のコンテナ。

CustomColumnError

カスタム列で発生する可能性のあるエラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
CUSTOM_COLUMN_NOT_FOUND カスタム列が見つかりませんでした。
CUSTOM_COLUMN_NOT_AVAILABLE カスタム列は使用できません。

DateErrorEnum

この型にはフィールドがありません。

考えられる日付エラーを記述する列挙型のコンテナ。

DateError

発生する可能性のある日付エラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
INVALID_FIELD_VALUES_IN_DATE 指定されたフィールド値が有効な日付に対応していません。
INVALID_FIELD_VALUES_IN_DATE_TIME 指定されたフィールド値が有効な日時に対応していません。
INVALID_STRING_DATE 文字列の日付は yyyy-mm-dd 形式にする必要があります。
INVALID_STRING_DATE_TIME_MICROS 文字列の日時は、yyyy-mm-dd hh:mm:ss.ssssss の形式にする必要があります。
INVALID_STRING_DATE_TIME_SECONDS 文字列の日時の形式は yyyy-mm-dd hh:mm:ss にする必要があります。
INVALID_STRING_DATE_TIME_SECONDS_WITH_OFFSET 文字列の日時は、yyyy-mm-dd hh:mm:ss+|-hh:mm の形式で指定する必要があります。
EARLIER_THAN_MINIMUM_DATE 日付が最小日付より前です。
LATER_THAN_MAXIMUM_DATE 日付が最大範囲より後です。
DATE_RANGE_MINIMUM_DATE_LATER_THAN_MAXIMUM_DATE 期間の範囲が順序どおりに設定されていません。
DATE_RANGE_MINIMUM_AND_MAXIMUM_DATES_BOTH_NULL 範囲内の日付が両方とも null です。

DateRangeErrorEnum

この型にはフィールドがありません。

考えられる期間エラーを記述する列挙型のコンテナ。

DateRangeError

期間に関する考えられるエラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受け取ったエラーコードは、このバージョンでは不明です。
INVALID_DATE 日付が無効です。
START_DATE_AFTER_END_DATE 開始日が終了日より後の日付になっています。
CANNOT_SET_DATE_TO_PAST 過去の日付を設定することはできません
AFTER_MAXIMUM_ALLOWABLE_DATE システムの「最終」日を過ぎた日付が使用されました。
CANNOT_MODIFY_START_DATE_IF_ALREADY_STARTED 開始済みのリソースの開始日を変更しようとしています。

DistinctErrorEnum

この型にはフィールドがありません。

考えられる個別のエラーを記述する列挙型のコンテナ。

DistinctError

考えられる個別のエラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
DUPLICATE_ELEMENT 要素が重複しています。
DUPLICATE_TYPE 重複するタイプ。

ErrorCode

タイプと列挙型で表されるエラーの理由。

フィールド
共用体フィールド error_code。エラー列挙型 error_code のリストは、次のいずれかになります。
request_error

RequestError

リクエストが原因で発生したエラー
query_error

QueryError

クエリにエラーがある
authorization_error

AuthorizationError

ユーザーを承認しようとした際にエラーが発生しました。
internal_error

InternalError

予期しないサーバーサイド エラー。
quota_error

QuotaError

残りの割り当て量に関するエラー。
authentication_error

AuthenticationError

ユーザーを適切に認証できなかったことを示します。
date_error

DateError

日付エラーの理由
date_range_error

DateRangeError

期間のエラーの理由
distinct_error

DistinctError

明確なエラーの原因
header_error

HeaderError

ヘッダーエラーの理由。
size_limit_error

SizeLimitError

サイズの上限エラーの理由
custom_column_error

CustomColumnError

カスタム列エラーの原因
invalid_parameter_error

InvalidParameterError

無効なパラメータ エラーの原因。

ErrorDetails

エラーの詳細。

フィールド
unpublished_error_code

string

返されるはずだったはずだったエラーコード。クライアントで指定されたバージョンでエラーコードが公開されていない場合に使用されます。
quota_error_details

QuotaErrorDetails

割り当てエラーの詳細（スコープ（アカウントまたはデベロッパー）、レートバケット名、再試行の遅延など）。

ErrorLocation

リクエスト プロトコルでエラーの原因となった部分を表します。

フィールド
field_path_elements[]

FieldPathElement

リクエストで無効だったフィールドを示すフィールドパス。

FieldPathElement

フィールドパスの一部。

フィールド
field_name

string

フィールドまたは oneof の名前
index

int32

field_name が繰り返しフィールドの場合は、失敗した要素です

HeaderErrorEnum

この型にはフィールドがありません。

発生する可能性のあるヘッダーエラーを記述する列挙型のコンテナ。

HeaderError

考えられるヘッダー エラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
INVALID_USER_SELECTED_CUSTOMER_ID ユーザーが選択したお客様 ID を検証できませんでした。
INVALID_LOGIN_CUSTOMER_ID ログイン ユーザー ID を検証できませんでした。

InternalErrorEnum

この型にはフィールドがありません。

発生する可能性のある内部エラーを記述する列挙型のコンテナ。

InternalError

発生する可能性のある内部エラーを表す列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
INTERNAL_ERROR API で予期しない内部エラーが発生しました。
ERROR_CODE_NOT_PUBLISHED 指定された API バージョンに、意図したエラーコードが存在しません。今後の API バージョンでリリースされる予定です。
TRANSIENT_ERROR API で予期しない一時的なエラーが発生しました。このような場合は、ユーザーがリクエストを再試行する必要があります。
DEADLINE_EXCEEDED リクエストが期限を過ぎています。

InvalidParameterErrorEnum

この型にはフィールドがありません。

無効なパラメータによって発生する可能性のあるエラーを記述する列挙型のコンテナ。

InvalidParameterError

発生する可能性のあるパラメータ エラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受け取ったエラーコードは、このバージョンでは不明です。
INVALID_CURRENCY_CODE 指定された通貨コードは無効です。

QueryErrorEnum

この型にはフィールドがありません。

考えられるクエリエラーを記述する列挙型のコンテナ。

QueryError

発生する可能性のあるクエリエラーを表す列挙型。

列挙型
UNSPECIFIED 名前が指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
QUERY_ERROR その他のクエリエラーの理由がすべて該当しない場合に返されます。
BAD_ENUM_CONSTANT クエリで使用されている条件が無効な列挙型定数を参照しています。
BAD_ESCAPE_SEQUENCE クエリに無効なエスケープ シーケンスが含まれています。
BAD_FIELD_NAME フィールド名が無効です。
BAD_LIMIT_VALUE 上限値が無効です（数値ではないなど）
BAD_NUMBER 検出された数値を解析できません。
BAD_OPERATOR 無効な演算子が検出されました。
BAD_PARAMETER_NAME パラメータが不明またはサポートされていません。
BAD_PARAMETER_VALUE パラメータの値が無効です。
BAD_RESOURCE_TYPE_IN_FROM_CLAUSE FROM 句に無効なリソースタイプが指定されています。
BAD_SYMBOL 文字列の外部で ASCII 以外の記号が検出されました。
BAD_VALUE 値が無効です。
DATE_RANGE_TOO_WIDE 日付フィルタで、31 日未満の範囲に日付を制限できない。クエリが日付別に分割されている場合に適用されます。
DATE_RANGE_TOO_NARROW 日付/週/月/四半期のフィルタの開始日が終了日より後です。
EXPECTED_AND BETWEEN 演算子を使用して値の間に AND を指定する必要があります。
EXPECTED_BY ORDER BY に BY が含まれていることが想定されています。
EXPECTED_DIMENSION_FIELD_IN_SELECT_CLAUSE ディメンション フィールドが選択されていません。
EXPECTED_FILTERS_ON_DATE_RANGE 日付関連フィールドにフィルタがない。
EXPECTED_FROM FROM 句がありません。
EXPECTED_LIST 条件で使用される演算子では、値がリストである必要があります。
EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE WHERE または ORDER BY 句で使用されるフィールドが SELECT 句にない。
EXPECTED_SELECT クエリの先頭に SELECT がありません。
EXPECTED_SINGLE_VALUE 演算子が単一の値を要求する条件に、リストが値として渡されました。
EXPECTED_VALUE_WITH_BETWEEN_OPERATOR BETWEEN 演算子で値が 1 つまたは両方指定されていません。
INVALID_DATE_FORMAT 日付形式が無効です。「YYYY-MM-DD」を指定する必要があります。
MISALIGNED_DATE_FOR_FILTER フィルタの日付値がずれている。フィルタリング対象のフィールドが segments.week、segments.month、segments.quarter の場合は、日付は週、月、四半期の開始日である必要があります。
INVALID_STRING_VALUE 渡された値が文字列であるべきなのに文字列ではありませんでした。たとえば、数値や引用符のないリテラルでした。
INVALID_VALUE_WITH_BETWEEN_OPERATOR BETWEEN 演算子に渡された文字列値は、日付として解析されません。
INVALID_VALUE_WITH_DURING_OPERATOR DURING 演算子に渡された値が日付範囲リテラルではない
INVALID_VALUE_WITH_LIKE_OPERATOR LIKE 演算子に値が渡されました。
OPERATOR_FIELD_MISMATCH フィルタリング対象のフィールドに適用できない演算子が指定されています。
PROHIBITED_EMPTY_LIST_IN_CONDITION 空のリストを含む条件が見つかりました。
PROHIBITED_ENUM_CONSTANT クエリで使用されている条件が、サポートされていない列挙型定数を参照しています。
PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE 一緒に選択できないフィールドが SELECT 句に含まれている。
PROHIBITED_FIELD_IN_ORDER_BY_CLAUSE 並べ替えできないフィールドが ORDER BY 句に含まれています。
PROHIBITED_FIELD_IN_SELECT_CLAUSE 選択できないフィールドが SELECT 句に含まれています。
PROHIBITED_FIELD_IN_WHERE_CLAUSE フィルタできないフィールドが WHERE 句に含まれています。
PROHIBITED_RESOURCE_TYPE_IN_FROM_CLAUSE FROM 句で指定されたリソースタイプは、このサービスではサポートされていません。
PROHIBITED_RESOURCE_TYPE_IN_SELECT_CLAUSE 互換性のないリソースから取得したフィールドが SELECT 句に含まれています。
PROHIBITED_RESOURCE_TYPE_IN_WHERE_CLAUSE 互換性のないリソースのフィールドが WHERE 句に含まれています。
PROHIBITED_METRIC_IN_SELECT_OR_WHERE_CLAUSE メインリソースまたは他の選択したセグメンテーション リソースと互換性のない指標が SELECT 句または WHERE 句に含まれています。
PROHIBITED_SEGMENT_IN_SELECT_OR_WHERE_CLAUSE SELECT 句または WHERE 句に、メインリソースまたは他の選択されたセグメンテーション リソースと互換性のないセグメントが含まれています。
PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE SELECT 句のセグメントは、SELECT 句または WHERE 句の指標に対応していません。
LIMIT_VALUE_TOO_LOW limit 句に渡された値が低すぎます。
PROHIBITED_NEWLINE_IN_STRING クエリに改行文字を含む文字列が含まれている。
PROHIBITED_VALUE_COMBINATION_IN_LIST リストに異なる型の値が含まれている。
PROHIBITED_VALUE_COMBINATION_WITH_BETWEEN_OPERATOR BETWEEN 演算子に渡された値の型が同じではありません。
STRING_NOT_TERMINATED クエリに終端されていない文字列が含まれています。
TOO_MANY_SEGMENTS SELECT 句で指定されているセグメントが多すぎます。
UNEXPECTED_END_OF_QUERY クエリが不完全で、解析できません。
UNEXPECTED_FROM_CLAUSE このクエリでは FROM 句を指定できません。
UNRECOGNIZED_FIELD 認識されないフィールドがクエリに 1 つ以上含まれています。
UNEXPECTED_INPUT クエリに予期しない余分な部分があります。
REQUESTED_METRICS_FOR_MANAGER クライアント センター（MCC）アカウントの指標はリクエストできません。指標を取得するには、MCC アカウントの各クライアント アカウントに対して個別のリクエストを送信します。
FILTER_HAS_TOO_MANY_VALUES フィルタ内の値（右側のオペランド）の数が上限を超えています。

QuotaErrorDetails

QuotaError がある場合の追加の割り当てエラーの詳細。

フィールド
rate_scope

QuotaRateScope

割り当て上限のレート スコープ。
rate_name

string

割り当てバケットの概要。たとえば、「標準アクセスのリクエストの取得」や「アカウントあたりのリクエスト数」などがあります。
retry_delay

Duration

ユーザーが次のリクエストを送信するまで待機する必要があるバックオフ期間。

QuotaRateScope

割り当てバケットが属する有効なスコープの列挙型。

列挙型
UNSPECIFIED 未指定の列挙型
UNKNOWN 戻り値にのみ使用されます。このバージョンでは不明な値を表します。
ACCOUNT 顧客アカウントごとの割り当て
DEVELOPER プロジェクトごとの割り当て

QuotaErrorEnum

この型にはフィールドがありません。

発生する可能性のある割り当てエラーを記述する列挙型のコンテナ。

QuotaError

発生する可能性のある割り当てエラーを説明する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
RESOURCE_EXHAUSTED リクエストが多すぎます。
RESOURCE_TEMPORARILY_EXHAUSTED 短期間でのリクエストが多すぎます。

RequestErrorEnum

この型にはフィールドがありません。

考えられるリクエスト エラーを記述する列挙型のコンテナ。

RequestError

考えられるリクエスト エラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受け取ったエラーコードは、このバージョンでは不明です。
RESOURCE_NAME_MISSING このリクエストではリソース名が必要です。
RESOURCE_NAME_MALFORMED 指定されたリソース名の形式が正しくありません。
BAD_RESOURCE_ID 指定したリソース名の形式が正しくありません。
INVALID_PRODUCT_NAME 商品名が無効です。
INVALID_CUSTOMER_ID お客様 ID が無効です。
OPERATION_REQUIRED ミューテーション オペレーションには、作成、更新、削除のいずれかを指定する必要があります。
RESOURCE_NOT_FOUND リクエストされたリソースが見つかりません。
INVALID_PAGE_TOKEN ユーザー リクエストで指定された次のページトークンが無効です。
EXPIRED_PAGE_TOKEN ユーザー リクエストで指定された次のページトークンの有効期限が切れています。
INVALID_PAGE_SIZE ユーザー リクエストで指定されたページサイズが無効です。
REQUIRED_FIELD_MISSING 必須欄が空白です。
IMMUTABLE_FIELD このフィールドは不変であるため、変更できません。また、フィールドは「create」オペレーションで変更できるが、「update」では変更できない場合もあります。
TOO_MANY_MUTATE_OPERATIONS リクエストで受信したエントリが多すぎます。
CANNOT_BE_EXECUTED_BY_MANAGER_ACCOUNT リクエストを MCC アカウントで実行できません。
CANNOT_MODIFY_FOREIGN_FIELD 変更リクエストが読み取り専用フィールドの変更を試みました。たとえば、予算フィールドは広告グループに対してリクエストできますが、adGroups:mutation の場合は読み取り専用です。
INVALID_ENUM_VALUE 列挙値は使用できません。
LOGIN_CUSTOMER_ID_PARAMETER_MISSING このリクエストには login-customer-id パラメータが必要です。
LOGIN_OR_LINKED_CUSTOMER_ID_PARAMETER_REQUIRED このリクエストでは、login-customer-id パラメータまたは linked-customer-id パラメータのいずれかが必要です。
VALIDATE_ONLY_REQUEST_HAS_PAGE_TOKEN page_token が検証専用リクエストで設定されている
CANNOT_RETURN_SUMMARY_ROW_FOR_REQUEST_WITHOUT_METRICS リクエストで指標フィールドが選択されていない場合、return_summary_row を有効にできません。
CANNOT_RETURN_SUMMARY_ROW_FOR_VALIDATE_ONLY_REQUESTS 検証のみのリクエストでは、return_summary_row を有効にしないでください。
INCONSISTENT_RETURN_SUMMARY_ROW_VALUE return_summary_row パラメータの値は、page_token フィールドが設定されたリクエストと元のリクエストで同じである必要があります。
TOTAL_RESULTS_COUNT_NOT_ORIGINALLY_REQUESTED 元のリクエストでリクエストされていない場合、結果の合計数を返すことはできません。
RPC_DEADLINE_TOO_SHORT クライアントが指定した期限が短すぎた。
PRODUCT_NOT_SUPPORTED リクエストに関連付けられているサービスは、現在のリクエストではサポートされていません。

SearchAds360Error

検索広告 360 固有のエラーです。

フィールド
error_code

ErrorCode

発生したエラーを示す列挙値。
message

string

人が読める形式のエラーの説明。
trigger

Value

エラーをトリガーした値。
location

ErrorLocation

エラーの原因となったリクエスト プロトコルの部分を説明します。
details

ErrorDetails

特定のエラーコードによって返されるエラーの詳細。ほとんどのエラーコードには詳細は含まれません。

SearchAds360Failure

Search Ads 360 API 呼び出しが失敗した理由を示します。呼び出しが失敗すると、google.rpc.Status.details 内に返されます。

フィールド
errors[]

SearchAds360Error

発生したエラーのリスト。
request_id

string

デバッグ目的で使用されるリクエストの一意の ID。

SizeLimitErrorEnum

この型にはフィールドがありません。

発生する可能性のあるサイズ上限エラーを記述する列挙型のコンテナ。

SizeLimitError

サイズの上限に関する考えられるエラーを記述する列挙型。

列挙型
UNSPECIFIED 列挙型は指定されていません。
UNKNOWN 受信したエラーコードはこのバージョンでは不明です。
REQUEST_SIZE_LIMIT_EXCEEDED リクエスト内のエントリ数がシステムの上限を超えているか、オペレーションの内容がサイズまたは複雑さのためにトランザクションの上限を超えている。リクエストあたりのエントリ数を減らしてみてください。
RESPONSE_SIZE_LIMIT_EXCEEDED レスポンスのエントリ数がシステムの上限を超えている。