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 开发者无权访问所查询的指标。

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 构成日期范围的上限与下限日期都为 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

描述了导致错误的请求 proto 的部分。

字段
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 运算符时缺少一个或两个值。
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 运算符的 String 值未解析为日期。
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 变异操作应指定创建、更新或移除。
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 变异请求试图修改只读字段。例如，可以为广告组请求预算字段，但对于 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

描述了导致错误的请求 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 响应中的条目数超过系统限制。