此页面由 Cloud Translation API 翻译。

常见错误

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

`google.auth.exceptions.RefreshError`

invalid_grant

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

CLIENT_CUSTOMER_ID_INVALID

CLIENT_CUSTOMER_ID_IS_REQUIRED

摘要	未在 HTTP 标头中指定客户账号的客户 ID。
常见原因	未在 HTTP 标头中指定客户帐号的客户 ID。
处理方式	不适用
预防建议	所有调用都必须提供客户帐号的客户 ID，因此请确保您已在 HTTP 标头中指定客户 ID。不妨考虑使用我们的客户端库，因为它们会为您处理此问题。

CUSTOMER_NOT_FOUND

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 指南。

CUSTOMER_NOT_ENABLED

摘要	该客户账号无法访问，因为该账号未处于启用状态。
常见原因	当客户帐号尚未完成注册或已停用时，就会发生这种情况。
处理方式	登录到 Google Ads 界面，确保您已完成此帐号的注册流程。如果帐号已被停用，请参阅重新激活已撤销的 Google Ads 帐号。
预防建议	您可以检查客户帐号状态是否为已取消，主动检查客户帐号是否已停用。

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。客户端库内置了对此操作的支持。