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 帳戶並未與 Search Ads 360 帳戶建立關聯。建立新帳戶,或是將 Google 帳戶加入現有的 Search Ads 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 無效。
TWO_STEP_VERIFICATION_NOT_ENROLLED 帳戶管理員已變更這個帳戶的驗證設定。如要存取這個帳戶,請前往 https://www.google.com/landing/2step,在 Google 帳戶中啟用兩步驟驗證。
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 使用者沒有對資源執行此動作的權限 (例如「新增」、「更新」、「移除」) 或呼叫方法。
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.sssss。
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 範圍內的兩個日期都是空值。

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

說明導致錯誤的 proto 部分。

欄位
field_path_elements[]

FieldPathElement

欄位路徑,指出要求中的哪個欄位無效。

FieldPathElement

欄位路徑的一部分。

欄位
field_name

string

欄位名稱或以下任一欄位名稱

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 值之間應為 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 SELECT 子句缺少 WHERE 或 ORDER BY 子句中使用的欄位。
EXPECTED_SELECT 查詢的開頭缺少 SELECT。
EXPECTED_SINGLE_VALUE 清單已做為值傳遞至條件,該條件的運算子需要單一值。
EXPECTED_VALUE_WITH_BETWEEN_OPERATOR 「BETWEEN」運算子缺少一或多個值,或兩者都缺少。
INVALID_DATE_FORMAT 無效的日期格式。預期的值為「YYYY-MM-DD」。
MISALIGNED_DATE_FOR_FILTER 篩選器的日期值不一致。如果篩選過的欄位為 segment.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 傳遞至限制子句的值過低。
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 查詢含有一或多個無法辨識的欄位。
UNEXPECTED_INPUT 查詢出現未預期的額外部分。
REQUESTED_METRICS_FOR_MANAGER 無法為管理員帳戶索取指標。如要擷取指標,請分別為管理員帳戶底下的各個客戶帳戶發出請求。
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 應指定建立、更新或移除的 Mutate 作業。
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 管理員帳戶無法執行要求。
CANNOT_MODIFY_FOREIGN_FIELD Mutate 要求嘗試修改唯讀欄位。舉例來說,您可以為廣告群組請求「預算」欄位,但 adGroups:mut 的唯讀欄位是唯讀的。
INVALID_ENUM_VALUE 不允許使用列舉值。
LOGIN_CUSTOMER_ID_PARAMETER_MISSING 此要求必須包含登入客戶 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 指定 page_token 欄位及其原始請求的「return_summary_row」參數值應相同。
TOTAL_RESULTS_COUNT_NOT_ORIGINALLY_REQUESTED 如果原始要求中未要求,就無法傳回結果總數。
RPC_DEADLINE_TOO_SHORT 用戶端指定的期限太短。
PRODUCT_NOT_SUPPORTED 目前的要求不支援與要求相關聯的產品。

SearchAds360Error

Search Ads 360 相關錯誤。

欄位
error_code

ErrorCode

指出發生錯誤的列舉值。

message

string

使用者容易理解的錯誤說明。

trigger

Value

觸發錯誤的值。

location

ErrorLocation

說明導致錯誤的 proto 部分。

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 回應中的項目數量超出系統上限。