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