本页列出了常见错误,并提供了有关如何预防和处理这些错误的提示。
如需查看完整的错误列表,请参阅错误参考。如需更多支持,请访问我们的论坛。
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 |
摘要 | 客户账号的客户 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 的指南。 |
|
|
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。客户端库已内置对此操作的支持。 |
|