系統會以 60 秒移動平均值檢查配額,允許使用量出現尖峰。根據預設,Classroom API 會受到下表所列限制:
限制 | 配額標準 |
---|---|
每個客戶每日的查詢量 | 4,000,000 (平均 46 QPS) |
每位客戶每分鐘的查詢次數 | 3,000 (每秒查詢 50 次) |
每位使用者的每分鐘查詢次數 | 1,200 (每秒查詢 20 次) |
允許的 QPS 可能會因多項營運因素而增加或減少。
如果您需要提出的請求數量超過專案的限制,請按照下列步驟操作:
- 首先,請務必重試要求,以回應可重試的錯誤 (例如要求超出限制時傳回的
RESOURCE_EXHAUSTED
錯誤),最好使用指數輪詢。 - 如果您要在提供此功能的端點上輪詢變更,建議改用推播通知。
- 如果您需要提出的請求數量仍超過專案指派的限制,請參閱下文,瞭解如何申請提高限制。
如要查看或變更專案的用量限制,或是想申請更多配額,請進行以下步驟:
- 確認您的專案已設有帳單帳戶。如果沒有,請先建立一個。
- 開啟 API 控制台並前往 API 程式庫「已啟用的 API」頁面,從清單中選取 API。
- 如要查看及變更配額相關設定,請點選「配額」。如要查看用量統計資料,請點選「用量」。