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