מגבלות ומכסות מגנות על התשתית של Google מפני תהליך אוטומטי שמשתמש ב-Reports API באופן בלתי הולם. בקשות מוגזמות מ-API עלולות לנבוע משגיאת הקלדה לא מזיקה, או כתוצאה ממערכת שתוכננה באופן לא יעיל שמבצעת קריאות API מיותרות. לא משנה מה הסיבה, חסימת תנועה ממקור ספציפי אחרי שהיא מגיעה לרמה מסוימת היא הכרחית לתקינות הכוללת של מערכת Google Workspace. כך ניתן להבטיח שהפעולות של מפתח אחד לא ישפיעו לרעה על הקהילה הרחבה יותר.
במקרה הנדיר שבו בקשת ה-API שלכם נכשלת, תקבלו תגובה של קוד סטטוס HTTP. קוד הסטטוס 403 מכיל פרטי שגיאה לגבי קלט שגוי, וקוד סטטוס HTTP 503 מכיל פרטי שגיאה שמציין את חריגה ממכסות ה-API. התגובות האלה מאפשרות לאפליקציה בהתאמה אישית לזהות את השגיאות האלה ולנקוט פעולה מתאימה.
אם צריך להשלים את הבקשות בפרק זמן קבוע, יש לשלוח את הבקשות במקביל או להשתמש במספר שרשורים באפליקציית Java או C# . דוגמה לבקשות מקבילות היא לבקש קבוצות קטנות של אימיילים ממשתמשים שונים במקום להוסיף או להסיר הרבה אימיילים ממשתמש אחד בו-זמנית. כשמדובר בשרשורים, כדאי להתחיל עם 10 שרשורים, שרשור אחד לכל כתובת אימייל של משתמש. חשוב לשים לב: ההמלצה לשרשורים כוללת יתרונות מרכזיים והיא לא מועילה לכל מצבי ה-API. אם מספר הבקשות גבוה מדי, יקרו שגיאות הקשורות למכסות.
עבור כל השגיאות המבוססות על זמן (עד N דברים ל-N שניות לשרשור), במיוחד שגיאות מסוג 503 של קוד סטטוס, מומלץ להפעיל את הקוד כך שיתעד את החריגה. באמצעות אלגוריתם של השהיה מעריכית, מומלץ להמתין זמן קצר לפני שמנסים שוב לבצע את הקריאה שנכשלה. דוגמה ל-Reports API עבור שרשור אחד היא להמתין 5 שניות ולנסות שוב את הקריאה שנכשלה. אם הבקשה בוצעה בהצלחה, חוזרים על התבנית הזו לשרשורים האחרים. אם הבקשה השנייה לא הצליחה, האפליקציה צריכה לצמצם את תדירות השליחה עד שהשיחה תבוצע בהצלחה. לדוגמה, אפשר להאריך את העיכוב הראשוני של 5 שניות ל-10 שניות ולנסות שוב את השיחה שנכשלה. בנוסף, קבעו מגבלה על מספר הניסיונות החוזרים. לדוגמה, אפשר לנסות לשלוח בקשה נוספת 5 עד 7 פעמים עם זמני השהיה שונים לפני שהאפליקציה מחזירה הודעת שגיאה למשתמש.
| קטגוריות הגבלת API | מגבלות |
|---|---|
| דיווח על שיעורי QPS ו-QPD | מספר הבקשות לפרויקט Google Cloud מוגבל על ידי ה-API.
במסוף Google Cloud, ערך ברירת המחדל שמוגדר כברירת מחדל הוא 2,400 שאילתות לדקה למשתמש בכל פרויקט ב-Google Cloud.
אפשר להגדיל את המגבלה דרך הדף 'מכסות API של Admin SDK' בפרויקט Google Cloud.
אם מתבצעת חריגה מהמגבלות, השרת יחזיר את קוד המצב HTTP 503. כשמנסים שוב לשלוח בקשות, צריך להשתמש באלגוריתם השהיה מעריכית. |
| קטגוריות מכסה ב-API | מכסות |
| תוצאות מקסימליות | מספר הרשומות שמפורטות בכל דף בתגובת API הוא 1 עד 1,000 אירועים. ברירת המחדל היא 1,000 רשומות. |
| מגבלות מסוגים אחרים | מגבלות והנחיות |
|---|---|
| פורמט נתונים, ברירת מחדל | פורמט הנתונים שמוגדר כברירת מחדל הוא JSON. ה-API תומך גם בפורמט Atom. |
| בקשות לא מורשות | Google לא מאפשרת לשלוח בקשות לא מורשות ל-API. בקשה נחשבת לא מורשית אם לא סופק אסימון הרשאה. למידע נוסף, אפשר לקרוא על בקשות הרשאה. |
| הודעות אזהרה |
|