מגבלות ומכסות

מגבלות ומכסות מגינות על התשתית של Google מפני תהליך אוטומטי שמשתמש ב-Enterprise License Manager API באופן בלתי הולם. בקשות מוגזמות מ-API עלולות לנבוע משגיאת הקלדה לא מזיקה, או למערכת שמעוצבת באופן לא יעיל שמבצעת קריאות ל-API מיותרות. לא משנה מה הסיבה, חסימת תנועה ממקור ספציפי אחרי שהיא מגיעה לרמה מסוימת היא הכרחית לשמירה על התקינות הכוללת של מערכת Google Workspace. המדיניות מבטיחה שהפעולות של מפתח אחד לא ישפיעו לרעה על הקהילה הרחבה יותר.

במקרה הלא סביר שבו בקשת ה-API שלכם נכשלת, תקבלו תגובת קוד סטטוס HTTP. קוד סטטוס 403 מכיל פרטי שגיאה לגבי קלט שגוי, וקוד סטטוס HTTP 503 מכיל פרטי שגיאה שמציין אילו מכסות API חרגתם. התגובות האלה מאפשרות לאפליקציה המותאמת אישית לזהות את השגיאות האלה ולנקוט פעולה מתאימה.

אם צריך להשלים את הבקשות בפרק זמן קבוע, שולחים אותן באצווה. בהתאם למטרת ה-API ואם מספר הבקשות גבוה מדי, יקרו שגיאות שקשורות למכסה.

אם אין לכם אפשרות להשתמש בתכונה המומלצת של בקשות מקובצות ל-API, השתמשו באלגוריתם של השהיה מעריכית לפני ניסיון חוזר (exponential backoff). לגבי כל השגיאות המבוססות על זמן (עד N דברים ל-X שניות לכל שרשור), במיוחד שגיאות בקוד סטטוס 503, מומלץ להפעיל את הקוד החריג. לאחר מכן, באמצעות אלגוריתם של השהיה מעריכית לפני ניסיון חוזר (exponential backoff), יש להמתין לעיכוב קל לפני שמנסים שוב את הקריאה שנכשלה. דוגמה ל-Enterprise License Manager API עבור שרשור אחד היא להמתין 5 שניות ולנסות שוב את הקריאה שנכשלה. אם הבקשה תתבצע בהצלחה, צריך לחזור על הדפוס הזה לגבי השרשורים האחרים. אם הבקשה השנייה לא מצליחה, האפליקציה צריכה להפסיק את תדירות הבקשה עד שהשיחה תסתיים בהצלחה. לדוגמה, אפשר להאריך את ההשהיה הראשונית של 5 שניות ל-10 שניות ולנסות שוב לבצע את השיחה שנכשלה. בנוסף, קבעו מגבלה על מספר הניסיונות החוזרים. לדוגמה, אפשר לנסות לבצע ניסיון חוזר של בקשה 5 עד 7 פעמים עם זמני השהיה שונים, לפני שהאפליקציה תחזיר שגיאה למשתמש.

קטגוריות של מכסת API	מכסות
שאילתות לשנייה (QPS)	מכסת QPS היא 1.

קטגוריות מוגבלות של ממשקי API	מגבלות
מחרוזת שאילתה מקסימלית של maxResults	הגודל המקסימלי של maxResults הוא 100.

סוגים אחרים של מגבלות	מגבלות והנחיות
בקשות אצווה	ה-API תומך בשליחה של בקשות אצווה.
פורמט נתונים בתשובות API	פורמט הנתונים של התגובה הוא JavaScript Object Notation (JSON).
הפעלה של Enterprise License Manager API	יש להפעיל את ה-API להקצאת משתמשים לפני ביצוע קריאות ל-Enterprise License Manager API. בלוח הבקרה, עבור לדף 'הגדרות' בכרטיסייה 'משתמשים וקבוצות' ומפעילים את ממשק ה-API להקצאת משתמשים. שומרים את השינויים. בנוסף, יש להפעיל ולהפעיל את שירות קבוצות Google.
בקשות לא מורשות	ה-API לא מקבל בקשות מורשות. בקשה נחשבת כלא מורשית אם לא סופק אסימון הרשאה. למידע נוסף, ראו מתן הרשאה לבקשות.