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 用户无权访问客户。注意：如果您要访问客户客户，则必须在 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

描述导致错误的请求 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 使用 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 传递给 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 查询包含一个或多个无法识别的字段。
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 操作应指定 create、update 或 remove。
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 Mutate 请求试图修改只读字段。例如，可以为广告组请求“预算”字段，但对于 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

特定于 SearchAds360 的错误。

字段
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 响应中的条目数超过系统限制。