מגבלות השימוש ב-API

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

בקשות API נכשלו

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

בקשות דחופות

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

שגיאות מבוססות-זמן

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

מכסות

קטגוריות המכסות של ה-API	מכסות
שאילתות ביום	אפשר לשלוח עד 100,000 שאילתות ביום. אם אתם צריכים קיבולת גדולה יותר למגבלה הזו, אפשר לשלוח בקשה הדף Quotas במסוף Google Cloud
תיאור קבוצה, גודל מקסימלי	אפשר להזין תיאור קבוצה באורך של עד 4,096 תווים.
שם קבוצה, גודל מקסימלי	שם קבוצה יכול להכיל עד 60 תווים.
defaultMessageDenyNotificationText	הטקסט של ההתראה יכול להכיל עד 10,000 תווים. לקבלת מידע נוסף על המדיניות בנושא בנכס defaultMessageDenyNotificationText, לצפייה הפניית API.
maxMessageBytes	גודל ההודעה המקסימלי כברירת מחדל הוא 1MB. מידע נוסף על maxMessageBytes הנכס, ראו את הפניית ה-API.

מגבלות

סוגי המגבלות	מגבלות והנחיות
פורמט נתונים, ברירת המחדל	פורמט הנתונים שמוגדר כברירת מחדל הוא JSON. ה-API תומך גם בפורמט Atom. גם JSON וגם Atom פורמטים של נתונים תומכים ביכולות קריאה-כתיבה מלאות. מידע נוסף זמין במאמר הבא: פורמטים של נתונים בפורמט JSON ו-Atom.
ממשק API של הגדרות קבוצות, הפעלה	עליך להפעיל את Directory API לפני ביצוע קריאות ל-Groups Settings API. מידע נוסף זמין במאמר הפעלת ממשקי API של Google Workspace.