מגבלת שימוש
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הבדיקה של המכסה מתבצעת על ממוצע נע של 60 שניות, שמאפשר עליות פתאומיות בשימוש. כברירת מחדל, Classroom API כפוף למגבלות שמפורטות בטבלה הבאה:
| מגבלה |
Quota Standard |
| שאילתות ביום לכל לקוח |
4,000,000 (ממוצע 46 QPS) |
| שאילתות לדקה לכל לקוח |
3,000 (50 QPS) |
| שאילתות בדקה לכל משתמש |
1,200 (20 שאילתות לשנייה) |
יכול להיות ש-QPS המותר יגדל או יקטן בהתאם למספר גורמים תפעוליים.
אם אתם צריכים לשלוח יותר בקשות מהמגבלות שחלות על הפרויקט:
- קודם כל, חשוב לוודא שאתם מגיבים לשגיאות שמאפשרות ניסיון חוזר (כמו השגיאה
RESOURCE_EXHAUSTED שמוחזרת כשבקשה חורגת מהמגבלות שלכם) על ידי ניסיון חוזר של הבקשה, רצוי באמצעות השהיה מעריכית לפני ניסיון חוזר.
- אם אתם מבצעים סקר שינויים בנקודת קצה שבה האפשרות הזו זמינה, כדאי להשתמש במקום זאת בהתראות Push.
- אם עדיין צריך לשלוח יותר בקשות מהמגבלות שהוקצו לפרויקט, בהמשך מוסבר איך לבקש הגדלה של המגבלות.
כדי לראות או לשנות את מגבלות השימוש בפרויקט, או כדי לבקש הגדלה של המכסה:
- אם עדיין אין לכם חשבון לחיוב לפרויקט, אתם צריכים ליצור חשבון כזה.
- נכנסים לדף Enabled APIs (ממשקי API מופעלים) ב-API library (ספריית API) ב-API Console ובוחרים API מהרשימה.
- כדי לראות ולשנות הגדרות שקשורות למכסות, בוחרים באפשרות מכסות. כדי לראות את נתוני השימוש, בוחרים באפשרות שימוש.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-01 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-01 (שעון UTC)."],[],[],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**."]]
