智能家居配额和限制

Google Home 会限制资源的分配和使用,并实施 相应的配额。具体政策取决于资源可用性、用户个人资料、服务使用记录和其他因素,如有更改,恕不另行通知。

HomeGraph API 限制

本部分列出了 Google Home Graph API 的速率限制。 这些限制适用于 RESTRPC API。

Google 会按Cloud-to-cloud 集成对您的查询、同步、删除、Report State和 异步请求同步 API 调用的集合应用每 60 秒 6,000 个请求的默认限制。

如需申请增加配额,请发送电子邮件至 ha-certification@google.com,并提供以下信息:

  • 电子邮件主题:Request to increase ReportState API Quota(申请增加 ReportState API 配额)
  • 电子邮件内容:
    • 项目 ID
    • 您的公司名称
    • 当前配额
    • 您希望增加配额的原因
Quota 限制 是否可以增加?
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 个请求的默认限制。

调试配额问题

如果您的集成遇到速率限制,请按照以下准则诊断和解决配额问题:

  1. Google 会对超出配额的 API 调用进行速率限制。这会导致状态不匹配,从而对您的集成产生负面影响。例如,如果 a ReportStateAndNotification 请求因速率限制而被丢弃,则 实体设备状态将无法同步,导致 Google Home app (GHA) 中的信息过时。

  2. 如果 RequestSync 是遇到错误的主要 API,请检查您的服务是否尝试为每个 agentUserId 发出多个并发调用。

  3. 查看流量随时间的变化情况。如果流量增长与设备数量增加、新设备类型发布或其他预期发布一致,请申请增加配额。如果流量意外增加,请检查您的集成,以确定是否是意外更改导致更多流量发送到 Home Graph API。