索引
AuthenticationErrorEnum
(消息)AuthenticationErrorEnum.AuthenticationError
(枚举)AuthorizationErrorEnum
(消息)AuthorizationErrorEnum.AuthorizationError
(枚举)CustomColumnErrorEnum
(消息)CustomColumnErrorEnum.CustomColumnError
(枚举)DateErrorEnum
(消息)DateErrorEnum.DateError
(枚举)DateRangeErrorEnum
(消息)DateRangeErrorEnum.DateRangeError
(枚举)DistinctErrorEnum
(消息)DistinctErrorEnum.DistinctError
(枚举)ErrorCode
(消息)ErrorDetails
(消息)ErrorLocation
(消息)ErrorLocation.FieldPathElement
(消息)HeaderErrorEnum
(消息)HeaderErrorEnum.HeaderError
(枚举)InternalErrorEnum
(消息)InternalErrorEnum.InternalError
(枚举)InvalidParameterErrorEnum
(消息)InvalidParameterErrorEnum.InvalidParameterError
(枚举)QueryErrorEnum
(消息)QueryErrorEnum.QueryError
(枚举)QuotaErrorDetails
(消息)QuotaErrorDetails.QuotaRateScope
(枚举)QuotaErrorEnum
(消息)QuotaErrorEnum.QuotaError
(枚举)RequestErrorEnum
(消息)RequestErrorEnum.RequestError
(枚举)SearchAds360Error
(消息)SearchAds360Failure
(消息)SizeLimitErrorEnum
(消息)SizeLimitErrorEnum.SizeLimitError
(枚举)
AuthenticationErrorEnum
此类型没有字段。
描述可能存在的身份验证错误的枚举的容器。
AuthenticationError
描述可能存在的身份验证错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中未知收到的错误代码。 |
AUTHENTICATION_ERROR |
请求的身份验证失败。 |
CLIENT_CUSTOMER_ID_INVALID |
客户账号的客户 ID 不是数字。 |
CUSTOMER_NOT_FOUND |
没有与所提供的客户 ID 相符的客户。 |
GOOGLE_ACCOUNT_DELETED |
客户的 Google 帐号已被删除。 |
GOOGLE_ACCOUNT_COOKIE_INVALID |
Cookie 中的账号登录令牌无效。 |
GOOGLE_ACCOUNT_AUTHENTICATION_FAILED |
Google 账号身份验证时出现问题。 |
GOOGLE_ACCOUNT_USER_AND_ADS_USER_MISMATCH |
Google 帐号登录令牌中的用户与 Cookie 中的用户 ID 不匹配。 |
LOGIN_COOKIE_REQUIRED |
进行身份验证时需要登录 Cookie。 |
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 标头格式不正确。 |
LOGIN_COOKIE_INVALID |
登录 Cookie 无效。 |
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 |
由请求导致的错误 |
query_error |
查询错误 |
authorization_error |
尝试向用户授权时出错。 |
internal_error |
发生意外的服务器端错误。 |
quota_error |
剩余配额数量错误。 |
authentication_error |
表示未能正确验证用户身份。 |
date_error |
日期错误的原因 |
date_range_error |
导致日期范围错误的原因 |
distinct_error |
出现不同错误的原因 |
header_error |
标头错误的原因。 |
size_limit_error |
出现大小限制错误的原因 |
custom_column_error |
导致自定义列错误的原因 |
invalid_parameter_error |
参数无效错误的原因。 |
ErrorDetails
更多错误详情。
字段 | |
---|---|
unpublished_error_code |
本应返回,但实际并未使用的错误代码。当错误代码未在客户端指定的版本中发布时,将使用此错误代码。 |
quota_error_details |
配额错误的详细信息,包括范围(账号或开发者)、速率存储分区名称和重试延迟。 |
ErrorLocation
描述导致错误的请求 proto 部分。
字段 | |
---|---|
field_path_elements[] |
指示请求中哪个字段无效的字段路径。 |
FieldPathElement
字段路径的一部分。
字段 | |
---|---|
field_name |
字段名称 |
index |
如果 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 |
过滤条件的日期值未对齐。如果过滤字段为 segment.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 |
配额限制的速率范围。 |
rate_name |
配额存储分区的简要说明。例如“获取标准权限的获取请求数”或“每个账号的请求数”。 |
retry_delay |
客户在发送下一个请求之前应等待的退避期。 |
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
特定于 Search Ads 360 的错误。
字段 | |
---|---|
error_code |
一个枚举值,用于指明发生了什么错误。 |
message |
人类可读的错误说明。 |
trigger |
触发错误的值。 |
location |
描述导致错误的请求 proto 部分。 |
details |
由某些错误代码返回的其他错误详情。大多数错误代码不包含详细信息。 |
SearchAds360Failure
说明 Search Ads 360 API 调用失败的方式。调用失败时,它在 google.rpc.Status.details 内返回。
字段 | |
---|---|
errors[] |
已发生的错误的列表。 |
request_id |
用于调试的请求的唯一 ID。 |
SizeLimitErrorEnum
此类型没有字段。
描述可能的大小限制错误的枚举容器。
SizeLimitError
描述可能的大小限制错误的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定枚举。 |
UNKNOWN |
此版本中未知收到的错误代码。 |
REQUEST_SIZE_LIMIT_EXCEEDED |
请求中的条目数超过系统限制,或者操作内容因大小或复杂性而超出事务限制。请尝试减少每个请求的条目数。 |
RESPONSE_SIZE_LIMIT_EXCEEDED |
响应中的条目数超过系统限制。 |