我们已为 Home API 实施配额系统,以确保服务可靠性并帮助开发者有效管理流量。Home API 中的配额位于 Google Cloud 项目级。
Home API 的速率限制为每个项目 30,000 QPM(每分钟查询次数)。此限制涵盖通过 Home API 发送的所有查询。
超出配额
超出 Home API 速率限制时,系统会抛出
resourceExhaused
HomeError。后续请求会立即被拒绝,并显示“超出配额”消息。
如果超出配额,应用应采用指数退避算法,并在操作受到暂时限制时通知用户。
监控
使用 Google Cloud 控制台实时监控用量,并 针对接近 Home API 配额的情况配置主动提醒。
如需查看当前指标,请前往与您在 Google Home Developer Console 中注册的应用关联的 Google Cloud 项目中的 Home API service 服务的指标 部分。
设置提醒
我们建议合作伙伴针对超出分配配额的阈值(例如 80%)的情况设置提醒。Google Cloud 中的提醒支持非常 广泛,并且高度可配置。
为配额创建提醒时,您需要在政策构建器中的消费者配额 > 配额 下使用以下指标。
- 分配配额用量 - serviceruntime.googleapis.com/quota/allocation/usage
- 配额限制 - serviceruntime.googleapis.com/quota/limit
合作伙伴还应设置通知渠道(例如电子邮件),以接收配额提醒。
如需详细了解提醒和通知,以及 如何在 Google Cloud 中配置它们,请参阅以下资源:
申请增加配额
如果您的应用具有合法流量,并且需要高于默认速率限制的限制,您可以申请增加配额。
如需查看用量和限制,请前往与您注册的应用关联的 Google Cloud 项目中的 Home API service 服务的 配额和系统限制 部分 in Developer Console.
如需申请增加配额,请修改特定配额。如需了解相关说明,请参阅 申请配额 调整 文档中的Google Cloud。