Google Classroom 外掛程式現已全面開放開發人員使用!詳情請參閱
外掛程式說明文件。
使用限制
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
系統會以 60 秒移動平均值檢查配額,允許用量尖峰。根據預設,Classroom API 會受到下表中的限制:
限制 |
配額標準 |
每個用戶端每日查詢次數 |
4,000,000 (平均 46 QPS) |
每位用戶每分鐘的查詢次數 |
3,000 (50 QPS) |
每位使用者每分鐘的查詢次數 |
1,200 (20 QPS) |
允許的 QPS 可能會因多項作業因素而增加或減少。
如果需要發出的要求數量超出專案的限制:
- 首先,請務必重試要求,以回應可重試的錯誤 (例如要求超出限制時傳回的
RESOURCE_EXHAUSTED
錯誤),最好是使用指數輪詢。
- 如果您在提供這項功能的端點輪詢變更,請考慮改用推播通知。
- 如果仍需提出超出專案配額的請求,請參閱下文,瞭解如何申請提高上限。
如要查看或變更專案的用量限制,或是想申請更多配額,請進行以下步驟:
- 確認您的專案已設有帳單帳戶。如果沒有,請先建立一個。
- 開啟 API 控制台並前往 API 程式庫「已啟用的 API」頁面,從清單中選取 API。
- 如要查看及變更配額相關設定,請點選「配額」。如要查看用量統計資料,請點選「用量」。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-01 (世界標準時間)。
[null,null,["上次更新時間:2025-08-01 (世界標準時間)。"],[],[],null,["# Usage Limits\n\nQuota is checked on a **60-second moving average** , which **allows for spikes in\nusage**. By default, the Classroom API is subject to the limits in the following\ntable:\n\n| Limit | Quota Standard |\n|-------------------------------|-------------------------|\n| Queries per day per client | 4,000,000 (Avg. 46 QPS) |\n| Queries per minute per client | 3,000 (50 QPS) |\n| Queries per minute per user | 1,200 (20 QPS) |\n\nThe permitted QPS may be increased or decreased depending on a number of\noperational factors.\n\nIf you need to make more requests than the limits applied to your project:\n\n1. First, ensure that you respond to retryable errors (such as the `RESOURCE_EXHAUSTED` error that is returned when a request exceeds your limits) by retrying the request, preferably using exponential backoff.\n2. If you are polling for changes on an endpoint where this is offered, consider using [push notifications](/workspace/classroom/guides/push-notifications) instead.\n3. If you still need to make more requests than the limits assigned to your project, see below for instructions on requesting higher limits.\n\nTo view or change usage limits for your project, or to request an increase to\nyour quota, do the following:\n\n1. If you don't already have a [billing account](//cloud.google.com/billing/docs/how-to/manage-billing-account) for your project, then create one.\n2. [Visit the Enabled APIs page of the\n API library](https://console.cloud.google.com/apis/enabled) in the API Console, and select an API from the list.\n3. To view and change quota-related settings, select **Quotas** . To view usage statistics, select **Usage**."]]