问题排查

您可以通过在 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。

如何在 API 错误时执行重试？

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

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

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