配额管理

我们已为 Home API 实现配额系统,以确保服务可靠性并帮助开发者有效管理流量。Home API 中的配额位于 Google Cloud 项目级层。

Home API 的速率限制为每个项目每分钟 30,000 次查询 (QPM)。此限制涵盖通过 Home API 发送的所有查询。

已超出配额

当超出 Home API 速率限制时,系统会抛出 resourceExhaused HomeException。后续请求将立即被拒绝,并显示“已超出配额”消息。

如果超出配额,应用应采用指数退避算法,并在操作暂时受限时通知用户。

监控

使用 Google Cloud 控制台实时监控使用情况,并配置主动提醒,以便在您接近 Home API 配额时收到提醒。

如需查看当前指标,请前往 Google Home Developer Console 中与应用注册相关联的 Google Cloud 项目的 Home API 服务的指标部分

设置提醒

我们建议合作伙伴设置提醒,以便在用量达到分配配额的某个阈值(例如 80%)时收到通知。Google Cloud 中的提醒支持非常广泛,并且高度可配置。

为配额创建提醒时,您需要在政策构建器中使用消费者配额 > 配额下的以下指标。

  • 分配配额用量 - serviceruntime.googleapis.com/quota/allocation/usage
  • 配额限制 - serviceruntime.googleapis.com/quota/limit

合作伙伴还应设置通知渠道(例如电子邮件),以便接收配额提醒。

如需详细了解提醒和通知,以及如何在 Google Cloud 中配置它们,请参阅以下资源:

申请增加配额

如果您的应用的合法流量需要高于默认速率限制的限制,您可以申请提高限制。

如需查看用量和限制,请前往 Developer Console 中与应用注册相关联的 Google Cloud 项目的 Home API 服务配额和系统限制部分。

如需申请增加配额,请修改特定配额。如需查看相关说明,请参阅 Google Cloud 文档中的申请配额调整