智慧型住宅配額與限制

Google Home會限制資源分配和使用,並依專案強制執行適當的配額。具體政策會因資源供應狀況、使用者個人資料、服務使用記錄和其他因素而異,並隨時可能在不另行通知的情況下變更。

HomeGraph API 限制

本節列出 Google Home Graph API 的頻率限制。這些限制適用於 REST 和 RPC API。

Google 預設限制每 60 秒最多 6,000 次要求,適用於每個 Cloud-to-cloud 整合的查詢、同步、刪除、Report State 和非同步要求同步 API 呼叫總和。

如要申請提高配額,請傳送電子郵件至 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。