常见错误

本页列出了常见错误，并提供了有关如何预防和处理这些错误的提示。 如需查看完整的错误列表，请参阅错误参考。如需更多支持，请访问我们的论坛。

google.auth.exceptions.RefreshError
invalid_grant	摘要 令牌已过期或撤消。 常见原因 如果 Google Cloud Platform 项目配置了针对外部用户类型的 OAuth 同意屏幕且发布状态为“Testing”，则系统会向其发放一个将在 7 天后过期的刷新令牌。 处理方法 您的 Google 项目的发布状态为“Testing”，因此刷新令牌每 7 天过期一次，并收到 invalid_grant 错误。前往 Google API 控制台，前往 OAuth 权限请求页面。然后，按照以下说明将发布状态更改为 In production，以免刷新令牌在 7 天后过期。 预防建议 查看未经验证的应用。

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	摘要 此运算符不能与广告子类一起使用。 常见原因 尝试修改广告的 status 以外的属性。 处理方法 不适用 预防建议 广告制作后就无法修改。如果您想修改广告，则必须制作新广告，然后移除旧广告。不过，您可以使用 MutateAdGroupAds 修改广告的 status。
INVALID_INPUT	摘要 广告中的某个字段包含无效字符。 常见原因 在网址中使用特殊字符。 处理方法 不适用 预防建议 在发出 API 请求之前，先验证应用中的网址。
LINE_TOO_WIDE	摘要 广告中的某个字段超出了所允许的长度上限。请参阅文字广告简介。 常见原因 一行文字过长。 处理方法 不适用 预防建议 在发出 API 请求之前，请先验证行的长度。

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	摘要 此标签已与某些广告相关联。 常见原因 正在尝试将标签与已关联的广告相关联。 处理方法 不适用 预防建议 首先检查要添加的标签是否已与广告相关联。
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	摘要 一项操作尝试更新已移除的广告。 常见原因 广告移除后便无法再更新，包括状态更改。 处理方法 不适用 预防建议 请确保您的代码不会尝试更新已移除的广告。

AdGroupCriterionError
INVALID_KEYWORD_TEXT	摘要 关键字文字包含无效字符。请参阅添加关键字。 常见原因 关键字文本包含无效字符。 处理方法 不适用 预防建议 在向 API 发出请求之前，先验证应用中的关键字文字。

AdGroupError
DUPLICATE_ADGROUP_NAME	摘要 正在添加或重命名一个广告组，但名称已经被其他广告组使用。 常见原因 使用正在投放或已暂停的现有广告组的名称制作新广告组。 处理方法 记录错误并向用户显示错误消息，可以选择推荐一个未使用的广告组名称或列出已被使用的名称。 预防建议 不适用

AssetError
DUPLICATE_ASSET	摘要 单个请求中的两个操作包含针对具有相同二进制数据的资产的创建操作。 常见原因 mutate 请求与包含相同二进制数据的重复创建操作。 处理方法 在单独的请求中创建资产，然后在后续请求中关联到该资产；或者，在同一请求中使用临时 ID。 预防建议 不适用

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	摘要 客户账号的客户 ID 不是数字。 常见原因 使用了不正确的客户帐号的客户 ID。 处理方法 不适用 预防建议 123-456-7890 应该是 1234567890。如需了解详情，请参阅开始使用。
CLIENT_CUSTOMER_ID_IS_REQUIRED	摘要 未在 HTTP 标头中指定客户账号的客户 ID。 常见原因 未在 HTTP 标头中指定客户帐号的客户 ID。 处理方法 不适用 预防建议 所有调用都需要客户帐号的客户 ID，因此，请确保您已在 HTTP 标头中指定一个客户 ID。请考虑使用我们的客户端库，因为它们会为您处理此问题。
CUSTOMER_NOT_FOUND	摘要 未找到与标头中提供的客户 ID 对应的账号。 常见原因 尝试访问的账号刚刚在后端建立之前创建。 处理方法 先等待五分钟，然后每 30 秒重试一次。 预防建议 创建帐号后，请等待几分钟，然后再针对该帐号发出请求。
GOOGLE_ACCOUNT_COOKIE_INVALID	摘要 请求标头中的访问令牌无效或已过期。 常见原因 访问令牌已失效。 处理方法 请求新令牌。如果您使用的是我们的客户端库，请参阅相关文档，了解如何刷新令牌。 预防建议 存储访问令牌并重复使用，直到它们过期为止。
NOT_ADS_USER	摘要 用于生成访问令牌的 Google 账号未与任何 Google Ads 账号关联。 常见原因 提供的登录信息对应于一个未启用 Google Ads 的 Google 帐号。 处理方法 请务必使用有效的 Google Ads 帐号（通常是您的经理帐号）登录 OAuth 流程。您还可以邀请 Google 帐号访问现有的 Google Ads 帐号，方法如下：登录您的经理帐号，选择相关客户或经理帐号，转到 Tools and Settings > Access and security，然后添加 Google 帐号电子邮件地址。 预防建议 不适用
OAUTH_TOKEN_INVALID	摘要 标头中的 OAuth 访问令牌无效。 常见原因 您通过 HTTP 标头传递的访问令牌不正确。 处理方法 不适用 预防建议 请确保您已传递与您账号关联的正确访问令牌。用户有时会将其与刷新令牌和授权代码混淆。如果希望获得可用于访问经理帐号下所有客户帐号的凭据，请确保获得了经理帐号的刷新令牌。如需了解详情，请参阅有关访问令牌和刷新令牌以及 OAuth2 的指南。

AuthorizationError
CUSTOMER_NOT_ENABLED	摘要 无法访问该客户账号，因为该账号未启用状态。 常见原因 当客户帐号未完成注册或已停用时，就会发生这种情况。 处理方法 登录到 Google Ads 界面，确保您已完成此账号的注册过程。对于已停用的帐号，请参阅重新激活已撤销的 Google Ads 帐号。 预防建议 您可以通过查看 CANCELLED 状态来主动检查客户帐号是否已停用。
DEVELOPER_TOKEN_NOT_APPROVED	摘要 开发者令牌仅获批用于测试帐号，并会尝试访问非测试帐号。 常见原因 测试开发者令牌用于访问非测试帐号。 处理方法 请确保您确实要访问非测试帐号。如果是这样，您需要申请将开发者令牌升级为标准权限或基本权限。 预防建议 不适用
DEVELOPER_TOKEN_PROHIBITED	摘要 请求中发送的项目不允许使用开发者令牌。 常见原因 每个 Google API 控制台项目只能与一个经理帐号的开发者令牌相关联。在您发出 Google Ads API 请求后，开发者令牌将与 Google API 控制台项目永久配对。如果您未使用新的 Google API 控制台项目，则会在发出请求时收到 DEVELOPER_TOKEN_PROHIBITED 错误。 处理方法 不适用 预防建议 如果要改用新经理帐号下的开发者令牌，您需要为使用新经理帐号令牌的 Google Ads API 请求创建新的 Google API 控制台项目。
USER_PERMISSION_DENIED	摘要 授权客户无法访问正在操作的客户。 常见原因 以有权访问经理帐号的用户身份进行身份验证，但未在请求中指定 login-customer-id。 处理方法 不适用 预防建议 将 login-customer-id 指定为不含连字符 (-) 的经理账号 ID。客户端库已内置对此操作的支持。

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	摘要 出价的值不是账号所用币种最小单位的整数倍。例如，0.015 美元（15000 的微单位）不是有效的出价。 常见原因 不适用 处理方法 不适用 预防建议 验证出价是否是帐号币种最小单位的整数倍。
BID_TOO_BIG	摘要 即使出价在广告系列预算范围内，也会返回此错误。 常见原因 不适用 处理方法 不适用 预防建议 检查帐号是否在参与 Google 广告助公益计划。如果是，请将每次点击费用出价限制在计划规定的上限范围内。

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	摘要 预算金额太低。 常见原因 不适用 处理方法 不适用 预防建议 验证预算金额是否高于或等于帐号所用币种的最小单位。
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	摘要 从以百万分之一为单位的金额转换为以账号币种计价的金额时，预算金额的小数位数太多。 常见原因 不适用 处理方法 不适用 预防建议 验证预算金额是否可以被帐号所用币种的最小单位整除。

CampaignError
DUPLICATE_CAMPAIGN_NAME	摘要 正在添加或重命名一个广告系列，但名称已经被其他广告系列使用。 常见原因 使用正在投放或已暂停的现有广告系列的名称制作新的广告系列。 处理方法 记录错误并向用户显示错误消息，可以选择推荐一个独一无二的广告系列名称或列出正在使用的名称。 预防建议 不适用

CriterionError
KEYWORD_HAS_INVALID_CHARS	摘要 添加或修改包含无效字符的关键字。 常见原因 在关键字中使用 ! @ % * 等特殊字符。 处理方法 不适用 预防建议 务必不要在关键字中使用任何不允许的字符。请参阅添加关键字。

DistinctError
DUPLICATE_ELEMENT	摘要 请求包含两个相同的冗余参数。 常见原因 不适用 处理方法 不适用 预防建议 在发出请求之前移除重复项（操作、参数、列表元素）。查找存在 DistinctElements 约束的字段。

InternalError
DEADLINE_EXCEEDED	摘要 请求超时，处理速度不够快，无法返回响应。 常见原因 发出的搜索请求生成的响应过大，或者 mutate 请求过大，无法处理。 处理方法 等待大约 30 秒，然后重试该请求。如果错误仍然存在，请尝试将请求分解为多个较小且可以更快完成的请求。 预防建议 请参阅细分，了解它对回答的长度有何影响。了解 gRPC 传输层限制。
INTERNAL_ERROR	摘要 处理请求时发生了意外。 常见原因 API 因发生错误而无法正常运行。 处理方法 使用指数退避算法进行重试，重试由于此错误而失败的所有请求。 预防建议 不适用
TRANSIENT_ERROR	摘要 出现暂时性的内部错误，需要重试。 常见原因 当 API 在内部遇到临时问题时，会发生此错误。 处理方法 使用指数退避算法进行重试，重试由于此错误而失败的所有请求。 预防建议 不适用

InvalidGrantError
invalid_grant (malformed auth code)	摘要 用于交换 OAuth 令牌的授权代码格式错误。 常见原因 当尝试为已获得请求应用访问权限的用户生成刷新令牌时，就会发生这种情况。例如，如果您为相同的 OAuth 客户端凭据和授权用户多次运行“生成用户凭据”示例，就可能出现这种情况。 处理方法 要为授权用户和 OAuth 客户端凭据的指定组合重新生成刷新令牌，请撤消现有的刷新令牌。请注意，撤消令牌会导致该令牌无法用于 Google Ads API 访问，而且会令用于生成刷新令牌的所有访问令牌失效。 预防建议 请务必将刷新令牌存储在安全的位置，以避免需要重新生成。

MutateError
RESOURCE_NOT_FOUND	摘要 请求引用了找不到的资源。 常见原因 该请求尝试更改或以其他方式引用不存在或已被移除的资源。或者，资源的指定资源名称格式有误。 处理方法 在提交 mutate 请求之前，使用搜索请求检索现有资源的资源名称。请参阅我们的客户端库指南，其中包括有关如何以每种受支持的语言构建有效资源名称的文档 预防建议 请勿手动创建资源名称。使用我们的客户端库提供的任一辅助方法。

NotEmptyError
EMPTY_LIST	摘要 某必填列表为空。 常见原因 向 mutate 方法传入空的操作列表。 处理方法 不适用 预防建议 不适用

QuotaError
RESOURCE_EXHAUSTED	摘要 超出了系统频率限额。 常见原因 不适用 处理方法 不适用 预防建议 在请求之间设置短暂的延迟，或者将更多操作组合到较少的请求中。

RangeError
TOO_LOW	摘要 某个值低于所允许的下限。 常见原因 忘记指定 ID，这会导致传入 0 值。 处理方法 不适用 预防建议 请注意 API 参考文档中记录的所有范围限制。

RequestError
INVALID_INPUT	摘要 请求格式错误。 常见原因 请求的网址或内容格式不正确。 处理方法 不适用 预防建议 不适用
REQUIRED_FIELD_MISSING	摘要 请求缺少必要的信息。 常见原因 尝试添加实体时缺少必填字段。 处理方法 记录错误并向用户显示错误消息。错误的 fieldPath 属性会指明缺少哪个字段。 预防建议 如需了解哪些是必填字段，请参阅 API 参考文档。

ResourceCountLimitExceededError
RESOURCE_LIMIT	摘要 该请求尝试创建的资源会导致这些资源的总数超过指定限制。 常见原因 特定上下文中可存在的资源数量有多种限制。 处理方法 查看系统限制，了解所遇到的限制。您可以重复使用现有资源，也可以移除资源，为新资源创建空间。 预防建议 使用搜索查询来监控存在限制的资源的数量。

StringLengthError
TOO_LONG	摘要 分配给指定字段的字符串超过上限。 常见原因 广告的标题或广告内容描述包含的文字过多。 处理方法 确定遇到的限制，相应地修改字符串，然后重新发送请求。 预防建议 请注意字符串长度限制。