使用限制

系統會以 60 秒移動平均值檢查配額,允許用量尖峰。根據預設,Classroom API 會受到下表中的限制:

限制 配額標準
每個用戶端每日查詢次數 4,000,000 (平均 46 QPS)
每位用戶每分鐘的查詢次數 3,000 (50 QPS)
每位使用者每分鐘的查詢次數 1,200 (20 QPS)

允許的 QPS 可能會因多項作業因素而增加或減少。

如果需要發出的要求數量超出專案的限制:

  1. 首先,請務必重試要求,以回應可重試的錯誤 (例如要求超出限制時傳回的 RESOURCE_EXHAUSTED 錯誤),最好是使用指數輪詢。
  2. 如果您在提供這項功能的端點輪詢變更,請考慮改用推播通知
  3. 如果仍需提出超出專案配額的請求,請參閱下文,瞭解如何申請提高上限。

如要查看或變更專案的用量限制,或是想申請更多配額,請進行以下步驟:

  1. 確認您的專案已設有帳單帳戶。如果沒有,請先建立一個。
  2. 開啟 API 控制台並前往 API 程式庫「已啟用的 API」頁面,從清單中選取 API。
  3. 如要查看及變更配額相關設定,請點選「配額」。如要查看用量統計資料,請點選「用量」