用量限制

配額檢查 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. 如要查看及變更配額相關設定,請點選「配額」。如要查看用量統計資料,請點選「用量」