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 不是有效的 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 使用者沒有存取客戶的權限。注意：如果您要存取客戶客戶，管理員的客戶 ID 必須設在 login-customer-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.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 範圍內的兩個日期皆為空值。

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 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 篩選器的日期值不正確。如果篩選欄位是 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 傳遞至限制子句的值過低。
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 變異操作應指定建立、更新或移除。
RESOURCE_NOT_FOUND 找不到要求的資源。
INVALID_PAGE_TOKEN 使用者要求中指定的下一頁權杖無效。
EXPIRED_PAGE_TOKEN 使用者要求中指定的下一頁符記已過期。
INVALID_PAGE_SIZE 使用者要求中指定的頁面大小無效。
REQUIRED_FIELD_MISSING 未填寫必填欄位。
IMMUTABLE_FIELD 這個欄位是不可變動的，因此無法修改。您也可以使用「建立」作業修改欄位，但無法使用「更新」作業。
TOO_MANY_MUTATE_OPERATIONS 收到的要求項目數量過多。
CANNOT_BE_EXECUTED_BY_MANAGER_ACCOUNT 管理員帳戶無法執行要求。
CANNOT_MODIFY_FOREIGN_FIELD 變更要求嘗試修改唯讀欄位。舉例來說，您可以為廣告群組要求預算欄位，但 adGroups:mutate 的預算欄位為唯讀。
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 含有設定 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

說明導致錯誤發生的請求原型部分。
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 回應中的項目數量超出系統限制。