常见错误

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

google.auth.exceptions.RefreshError

invalid_grant

总结令牌已过期或已撤消。
常见原因如果 Google Cloud Platform 项目的 OAuth 同意屏幕配置为外部用户类型,且发布状态为“正在测试”,则会获得一个刷新令牌,该令牌将在 7 天后过期。
处理建议在您的 Google 项目中,您将发布状态设置为“正在测试”,以便刷新令牌每 7 天过期一次,并收到“invalid_grant”错误。转到 Google API 控制台并导航到 OAuth 同意屏幕。然后,按照这些说明将发布状态更改为“正式版”,以免刷新令牌在 7 天后过期。
预防建议请按照这些说明操作。

广告错误

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR

总结此运算符不能与广告子类一起使用。
常见原因您尝试修改广告属性以外的属性。status
处理建议不适用
预防建议广告制作后就无法修改。如果您想修改广告,则必须制作新广告,然后移除旧广告。不过,广告的 status 可通过 MutateAdGroupAds 进行修改

INVALID_INPUT

总结广告中的某个字段包含无效字符。
常见原因在网址中使用了特殊字符
处理建议不适用
预防建议在向 API 发出请求之前,先验证应用中的网址。

LINE_TOO_WIDE

总结广告中的某个行超出了所允许的长度上限。Google Ads 帮助中心内提供了有关长度限制的说明。
常见原因在广告参数标记中错误地指定了空的默认文本。请使用 {param1},而不要使用 {param1:}
处理建议不适用
预防建议在发出请求之前,先验证行的长度。

AdGroupAdError

AD_GROUP_AD_LABEL_ALREADY_EXISTS

总结此标签已与这些广告中的部分广告关联。
常见原因您尝试将标签与已关联的广告相关联。
处理建议不适用
预防建议首先检查要添加的标签是否已与广告相关联。

CANNOT_OPERATE_ON_REMOVED_ADGROUPAD

总结一项操作尝试更新已移除的广告。
常见原因广告移除后便无法再更新(包括状态调整)。
处理建议不适用
预防建议确保您的代码不会尝试更新已移除的广告。

AdGroupCriterionError

INVALID_KEYWORD_TEXT

总结关键字文字包含无效字符。Google Ads 帮助中心内提供了有效字符的列表。
常见原因关键字文字包含无效字符。
处理建议不适用
预防建议在向 API 发出请求之前,先验证应用中的关键字文字。

AdGroupError

DUPLICATE_ADGROUP_NAME

总结正在添加或重命名一个广告组,但名称已经被其他广告组使用。
常见原因创建新广告组时,选择了正在使用或已暂停的现有广告组的名称。
处理建议记录错误和/或向用户显示错误消息,可以选择推荐一个未使用的广告组名称或列出已被使用的名称。
预防建议不适用

身份验证错误

CLIENT_CUSTOMER_ID_INVALID

摘要客户帐号的客户 ID 不是数字。
常见原因您为客户帐号指定了错误的客户 ID。
处理建议不适用
预防建议123-456-7890 应该是 1234567890。如需了解详情,请访问我们的快速入门

CLIENT_CUSTOMER_ID_IS_REQUIRED

总结未在 HTTP 标头中指定客户帐号的客户 ID。
常见原因您未在 HTTP 标头中指定客户帐号的客户 ID。
处理建议不适用
预防建议在所有情况下(除了使用 CustomerService.GetCustomer 时),您都必须指定客户帐号的客户 ID。因此,请确保您已在 HTTP 标头中指定了客户 ID。建议您使用我们的客户端库,因为它们会为您处理此操作。

CUSTOMER_NOT_FOUND

摘要未找到与标头中提供的客户 ID 对应的帐号。
常见原因尝试访问刚刚创建但还没有在后端建立的帐号。
处理建议先等待五分钟,然后每隔 30 秒重试一次。
预防建议创建帐号后,先等待几分钟再对其发出请求。
总结请求标头中的访问令牌无效或已过期。
常见原因访问令牌已失效。
处理建议按照这些准则请求新令牌。如果您在使用我们的某个客户端库,请参阅相关文档以了解如何刷新令牌。
预防建议存储访问令牌并重复利用,直到它们过期为止。

NOT_ADS_USER

总结用于生成访问令牌的登录信息未与任何 Google Ads 帐号关联。
常见原因提供的登录信息对应于一个未启用 Google Ads 的 Google 帐号。
处理建议请务必使用有效的 Google Ads 帐号(通常是您的经理帐号)登录 OAuth 流程。
预防建议不适用

OAUTH_TOKEN_INVALID

总结标头中的 OAuth 访问令牌无效。
常见原因您使用 HTTP 标头传递的访问令牌不正确。
处理建议不适用
预防建议请确保您已传递与您帐号关联的正确访问令牌。用户有时会将其与刷新令牌和授权代码混淆。如果您希望获得可访问经理帐号下所有客户帐号的凭据,则务必要取得该经理帐号的刷新令牌。如需详细了解访问令牌和刷新令牌,请参阅我们的指南。有关详情,请参阅 OAuth2 身份验证指南

授权错误

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

总结出价的值不是帐号所用币种最小单位的整数倍。例如,US$0.015(15000 个百万分之一)不是有效的出价。
常见原因不适用
处理建议不适用
预防建议验证出价是否是该帐号币种最小单位的整数倍。

BID_TOO_BIG

总结即使出价在广告系列预算范围内,也会返回此错误。
常见原因不适用
处理建议不适用
预防建议检查帐号是否在参与 Google Grants for Google Ads 计划。如果是,请将每次点击费用出价限制在计划规定的上限范围内。

CampaignBudgetError

MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC

总结预算金额太低。
常见原因不适用
处理建议不适用
预防建议验证预算金额是否高于或等于帐号所用币种的最小单位。

NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT

总结从以百万分之一为单位的金额转换为以帐号币种计价的金额时,预算金额的小数位数太多。
常见原因不适用
处理建议不适用
预防建议验证预算金额是否可以被帐号所用币种的最小单位整除。

广告系列错误

DUPLICATE_CAMPAIGN_NAME

总结正在添加或重命名一个广告系列,但名称已经被其他广告系列使用。
常见原因使用有效或暂停的现有广告系列的名称制作新广告系列。
处理建议记录错误和/或向用户显示错误消息,可以选择推荐一个未使用的广告系列名称或列出已被使用的名称。
预防建议不适用

CriterionError

KEYWORD_HAS_INVALID_CHARS

摘要添加/修改包含无效字符的关键字。
常见原因在关键字中使用 ! @ % * 等特殊字符。
处理建议不适用
预防建议务必不要在关键字中使用任何不允许的字符。如需了解详情,请参阅添加关键字帮助中心文章。

Distinct 错误

DUPLICATE_ELEMENT

总结请求包含两个相同的冗余参数。
常见原因不适用
处理建议不适用
预防建议在发出请求之前移除重复项(操作、参数、列表元素)。查找具有 DistinctElements 约束的字段。

内部 API 错误

INTERNAL_ERROR

总结处理请求时发生了意外。
常见原因API 因发生错误而无法正常运行。
处理建议等待大约 30 秒,然后重试请求。如果经常出现此错误,请将详细信息发布到论坛中以进一步排查问题。
预防建议不适用

无效授权

invalid_grant (Malformed auth code)

总结用于交换 OAuth 令牌的授权代码格式不正确。
常见原因尝试为已向请求权限的应用授予访问权限的用户生成刷新令牌时,就会发生这种情况。例如,针对同一 OAuth 客户端凭据向用户授权并多次运行生成用户凭据示例时,可能会发生这种情况。
处理建议要为指定的用户凭据和 OAuth 客户端凭据的组合重新生成刷新令牌,请按照这些说明撤消现有的刷新令牌。请注意,撤消令牌会导致该令牌无法再用于 Google Ads API 访问,并会使用于刷新令牌的访问令牌失效。
预防建议请务必将刷新令牌存储在安全的位置,以免重新生成密钥。

NotEmptyError

EMPTY_LIST

总结某必填列表为空。
常见原因mutate 方法传递了空的操作列表。
处理建议不适用
预防建议不适用

配额错误

RESOURCE_EXHAUSTED

总结超出了系统频率限额。
常见原因在短时间内发送的请求太多。
处理建议不适用
预防建议在请求之间设置短暂的延迟,或者将较多的操作组合到较少的请求中。

范围错误

TOO_LOW

总结某个值低于所允许的下限。
常见原因忘记指定 ID,导致传递的某个值为 0。
处理建议不适用
预防建议留意 API 参考中记录的任何范围限制。

RequestError

INVALID_INPUT

总结请求格式错误。
常见原因网址或请求内容的格式不正确。
处理建议不适用
预防建议不适用

RequestError

REQUIRED_FIELD_MISSING

总结请求缺少必要的信息。
常见原因在尝试添加实体时未提供必要的字段
处理建议记录错误和/或向用户显示错误消息。错误的 fieldPath 属性会指明缺少哪个字段。
预防建议参阅 API 参考,了解哪些字段是必不可少的。