המכסה נבדקת לפי ממוצע נע של 60 שניות, כדי לאפשר עליות חדות בשימוש. כברירת מחדל, Classroom API כפוף למגבלות שמפורטות בטבלה הבאה:
| מגבלה | Quota Standard |
|---|---|
| שאילתות ליום לכל לקוח | 4,000,000 (ממוצע 46 בקשות לשנייה) |
| שאילתות לדקה לכל לקוח | 3,000 (50 QPS) |
| שאילתות בדקה לכל משתמש | 1,200 (20 שאילתות לשנייה) |
יכול להיות ששיעור הבקשות לשנייה (QPS) המורשה יגדל או יקטן בהתאם למספר גורמים תפעוליים.
אם אתם צריכים לשלוח יותר בקשות מהמגבלות שחלות על הפרויקט:
- קודם כול, חשוב לוודא שאתם מגיבים לשגיאות שניתן לנסות שוב (כמו השגיאה
RESOURCE_EXHAUSTEDשמוחזרת כשבקשה חורגת מהמגבלות שלכם) על ידי ניסיון חוזר לבקשה, רצוי באמצעות השהיה מעריכית לפני ניסיון חוזר (exponential backoff). - אם אתם מבצעים סקרים לגבי שינויים בנקודת קצה שבה האפשרות הזו זמינה, כדאי לכם להשתמש במקום זאת בהתראות דחיפה.
- אם עדיין צריך לשלוח יותר בקשות מהמגבלות שהוקצו לפרויקט, בהמשך מפורטות הוראות לשליחת בקשה להגדלת המגבלות.
כדי להציג או לשנות את מגבלות השימוש בפרויקט, או כדי לבקש הגדלת מכסה:
- אם עדיין אין לכם חשבון לחיוב בפרויקט, צריך ליצור חשבון כזה.
- נכנסים לדף Enabled APIs בספריית ה-API במסוף API ובוחרים ממשק API מהרשימה.
- כדי להציג ולשנות הגדרות שקשורות למכסות, בוחרים באפשרות Quotas. כדי להציג את נתוני השימוש, בוחרים באפשרות שימוש.