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