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