Google Home 会限制资源的分配和使用,并按项目强制执行相应的配额。具体政策取决于资源可用性、用户个人资料、服务使用记录和其他因素,如有更改,恕不另行通知。
HomeGraph API 限制
本部分列出了 Google Home Graph API 的速率限制。 这些限制同时适用于 REST 和 RPC API。
Google 会按 Cloud-to-cloud 集成对您的查询、同步、删除、Report State和异步请求同步 API 调用的集合应用每 60 秒 6,000 个请求的默认限制。
如需申请增加配额,请发送电子邮件至 ha-certification@google.com,并提供以下信息:
- 电子邮件主题:请求提高 ReportState API 配额
- 邮件内容:
- 项目 ID
- 您的公司名称
- 当前配额
- 您希望增加配额的原因
| 配额 | 限制 | 是否可以增加? |
|---|---|---|
| RequestSync(同步模式) | 每个 agentUserId 最多 1 个并发请求。
|
否 |
| RequestSync(异步模式) | 每个 Cloud-to-cloud 集成的默认限制为每 60 秒 6,000 个请求。 | 是 |
| 查询 | 每个 Cloud-to-cloud 集成每 60 秒 6,000 个请求的默认限制。 | 是 |
| 同步 | 每个 Cloud-to-cloud 集成每 60 秒 6,000 个请求的默认限制。 | 是 |
| 删除 | 每个 Cloud-to-cloud 集成每 60 秒 6,000 个请求的默认限制。 | 是 |
| ReportStateAndNotification | 每个 Cloud-to-cloud 集成每 60 秒 6,000 个请求的默认限制。 | 是 |
调试配额问题
如果您的集成遇到速率限制,请使用以下指南来诊断和解决配额问题:
Google 会对超出配额的 API 调用进行速率限制。这会导致状态不匹配,从而对集成产生负面影响。例如,如果
ReportStateAndNotification请求因速率限制而被丢弃,实体设备状态将无法同步,从而导致 Google Home app (GHA) 包含过时的信息。如果
RequestSync是出现错误的主要 API,请检查您的服务是否尝试对每个agentUserId进行多次并发调用。查看流量随时间增长的情况。如果这种增长与设备数量增加、新设备类型发布或其他一些预期发布一致,请申请增加配额。如果这种增加是意外情况,请检查您的集成,确定是否是意外更改导致向 Home Graph API 发送了更多流量。