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

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 更改操作应指定“创建”“更新”或“移除”。
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 响应中的条目数超过系统限制。