使用限制

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

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

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

如果您需要提出的請求數量超過專案的限制,請按照下列步驟操作:

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

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

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