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 次要求。 | 是 |
偵錯配額問題
如果整合功能受到頻率限制,請按照下列指南診斷及解決配額問題:
Google 會限制超出配額的 API 呼叫頻率。這會導致狀態不符,對整合造成負面影響。舉例來說,如果
ReportStateAndNotification要求因頻率限制而遭捨棄,實體裝置狀態將無法同步,導致 Google Home app (GHA) 留有過時資訊。如果
RequestSync是出現錯誤的主要 API,請檢查您的服務是否嘗試對每個agentUserId進行超過一次的並發呼叫。查看流量隨時間的成長情況。如果這項成長與裝置數量增加、推出新裝置類型或其他預期推出的產品一致,請要求提高配額。如果這項增加不符合預期,請檢查整合,判斷是否有非預期的變更導致更多流量傳送至 Home Graph API。