问题排查

您可以在 Google Cloud 项目中启用所需的服务并验证调用方权限,从而解决常见的 Google API 错误。您应应用指数退避算法重试来从瞬时配额失败中恢复。

“服务未启用”错误是什么意思?

要使用任何 Google API 服务,您需要执行以下操作:

  1. 创建或使用现有 Google Cloud 项目。
  2. 为 Google Cloud 项目启用相应服务。
  3. 传递与Google Cloud 项目关联的 API 密钥或 OAuth 访问令牌。

如需详细了解如何使用 API 密钥,请参阅 Google Cloud API 和服务的身份验证。如需修正此错误,请按照启用和停用服务中的说明,为您的 Google Cloud 项目启用 Service Usage API。

如何修复权限遭拒错误?

此类错误通常意味着调用者没有适当的 Identity and Access Management 权限。如需详细了解如何修复此错误,请参阅访问权限控制指南。

如何在收到 API 错误时执行重试?

如果您收到 API 错误并想重试调用,我们建议您以指数间隔随机执行重试。对于消息指出的错误,请使用以下最小重试间隔:

  • 429 配额错误间隔 30 秒。
  • 500 配额错误间隔 1 秒。
  • 503 配额错误间隔 1 秒。

对于其他错误,请确保根据其他错误信息执行重试。如需了解详情,请参阅 google.rpc.Code。