Google Home 會限制資源分配和使用,並依據每項專案的情況調整可用配額。具體規定會因資源供應狀況、使用者結構、服務使用記錄和其他因素而有不同,並隨時可能變更,恕不另行通知。
HomeGraph API 限制
本節列出 Google Home Graph API 的速率限制。這些限制適用於 REST 和 RPC API。
Google 會對查詢、同步、刪除、Report State 和非同步要求同步 API 呼叫的總和,套用每 60 秒 6,000 個要求的預設限制,並以每個Cloud-to-cloud整合為單位。
如要申請提高配額,請傳送電子郵件到 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 個要求。 | 是 |
偵錯配額問題
如果整合作業遇到頻率限制,請按照下列指南診斷及解決配額問題:
如果 API 呼叫次數超過配額,Google 會限制頻率。這會導致狀態不符,對整合造成負面影響。舉例來說,如果
ReportStateAndNotification要求因頻率限制而遭捨棄,實體裝置狀態就會無法同步,導致 Google Home app (GHA) 資訊過時。如果
RequestSync是發生錯誤的主要 API,請檢查服務是否嘗試對每個agentUserId進行多個並行呼叫。查看流量隨時間的成長情況。如果這項成長與裝置數量增加、推出新裝置類型或其他預期發布內容一致,請要求增加配額。如果這項增幅出乎意料,請檢查整合功能,判斷是否因意外變更而導致更多流量傳送至 Home Graph API。