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