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