智能家居配额和限制

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 个请求的默认限制。 是

调试配额问题

如果您的集成遇到速率限制,请使用以下指南来诊断和解决配额问题:

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

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

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