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 使用者沒有對資源執行這項操作 (例如 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 開發人員無權存取所查詢的指標。

ConversionCustomVariableErrorEnum

這個類型沒有任何欄位。

列舉的容器，說明可能的轉換自訂變數錯誤。

ConversionCustomVariableError

列舉說明可能的轉換自訂變數錯誤。

列舉
UNSPECIFIED 未指定列舉。
UNKNOWN 這個版本不包含收到的錯誤代碼。
DUPLICATE_NAME 已有同名的轉換自訂變數。
DUPLICATE_TAG 指定代碼的轉換自訂變數已存在。
RESERVED_TAG 指定代碼的轉換自訂變數保留給其他用途。
NOT_FOUND 找不到轉換自訂變數。
NOT_AVAILABLE 無法使用轉換自訂變數。
INCOMPATIBLE_TYPE 要求的轉換自訂變數與目前的請求不相容。
INVALID_METRIC 要求的轉換自訂變數不是指標類型。
EXCEEDS_CARDINALITY_LIMIT 轉換自訂變數的基數超過區隔上限。
INVALID_DIMENSION 要求的轉換自訂變數不是維度類型。
INCOMPATIBLE_WITH_SELECTED_RESOURCE 所要求的轉換自訂變數與所選資源不相容。

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

造成錯誤的原因
conversion_custom_variable_error

ConversionCustomVariableError

轉換自訂變數發生錯誤的原因
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 Expecting ORDER BY to have 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 回應中的項目數量超出系統上限。