Google Ads API is returning to beta status. Please read our blog post for more details.

常见错误

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

AdError

CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR

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

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

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

AuthenticationError

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 身份验证指南

AuthorizationError

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

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

CampaignError

DUPLICATE_CAMPAIGN_NAME

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

CriterionError

KEYWORD_HAS_INVALID_CHARS

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

DistinctError

DUPLICATE_ELEMENT

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

InternalApiError

NTERNAL_ERROR

摘要处理请求时发生了意外。
常见原因API 因发生错误而无法正常运行。
处理建议等待大约 30 秒后重新尝试发出请求。如果此错误频繁发生,请将详细信息发布到论坛上以进一步排查问题。
预防建议

NotEmptyError

EMPTY_LIST

摘要某必填列表为空。
常见原因mutate 方法传递了空的操作列表。
处理建议
预防建议

QuotaCheckError

RESOURCE_EXHAUSTED

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

RangeError

TOO_LOW

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

RequestError

INVALID_INPUT

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

RequiredError

REQUIRED_FIELD_MISSING

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