我們已為 Home API 導入配額系統,確保服務可靠性,並協助開發人員有效管理流量。Home API 的配額位於 Google Cloud 專案層級。
每個專案的 Home API 頻率限制為每分鐘 30,000 次查詢 (每分鐘的要求數量)。透過 Home API 傳送的所有查詢都會計入這項限制。
超過配額
如果超過 Home API 的頻率限制,系統會擲回 resourceExhaused
HomeException,並立即拒絕後續要求,顯示「超出配額」訊息。
如果超出配額,應用程式應採用指數輪詢,並在暫時限制動作時通知使用者。
監控
使用 Google Cloud 控制台即時監控用量,並在接近 Home API 配額時設定主動式快訊。
如要查看目前的指標,請前往Google Home Developer Console中與應用程式註冊相關聯的 Google Cloud 專案,然後開啟「Home API service」(Home API 服務),並前往「Metrics」(指標) 部分。
設定快訊
建議合作夥伴為配額超過門檻 (例如 80%) 設定快訊。Google Cloud 的快訊支援功能非常廣泛,且可高度設定。
建立配額快訊時,請在政策建構工具中,使用「消費者配額」>「配額」下的下列指標。
- 分配配額用量 - serviceruntime.googleapis.com/quota/allocation/usage
- 配額限制 - serviceruntime.googleapis.com/quota/limit
合作夥伴也應設定通知管道 (例如電子郵件),以便接收配額快訊。
如要進一步瞭解快訊和通知,以及如何在 Google Cloud 中設定這些功能,請參閱下列資源:
申請提高配額
如果應用程式的合法流量需要高於預設速率限制的上限,您可以申請提高上限。
如要查看用量和限制,請前往Developer Console中與應用程式註冊相關聯的 Google Cloud 專案,然後在「Home API 服務」的配額與系統限制部分查看。
如要申請提高配額,請編輯特定配額。如需相關操作說明,請參閱 Google Cloud 說明文件中的「要求調整配額」。