מגבלות ומכסות מגינות על התשתית של Google מפני תהליך אוטומטי שמשתמש ב-Groups Migration API באופן בלתי הולם. בקשות רבות מדי מ-API עלולות לנבוע משגיאת הקלדה לא מזיקה, או ממערכת לא יעילה שמבצעת קריאות ל-API לא נחוצות. לא משנה מה הסיבה, חסימת התנועה ממקור ספציפי כשהיא מגיעה לרמה מסוימת היא הכרחית לתקינות הכוללת של מערכת Google Workspace.
בקשות API שנכשלו
במקרה הלא סביר שבו בקשת ה-API שלך נכשלת, האפליקציה תקבל תגובה של קוד סטטוס HTTP. קוד מצב ה-HTTP של 403 מכיל פרטי שגיאה לגבי קלט שגוי, וקוד מצב HTTP של 503 מכיל פרטי שגיאה שמציינת שמכסות ה-API חרגו ממכסות ה-API. התגובות האלה מאפשרות לאפליקציה המותאמת אישית לזהות את השגיאות האלה ולנקוט פעולה מתאימה.
בקשות רגישות לזמן
אם צריך להשלים את הבקשות בפרק זמן קבוע, שלחו את הבקשות במקביל או השתמשו במספר שרשורים באפליקציית Java או C#. לדוגמה, כדאי לפרט את הבקשות לפי חודש או לפי תקופה אחרת. אם מדובר בשרשורים, כדאי לנסות להתחיל עם 10 שרשורים, שרשור אחד לכל בקשה. ההמלצה לשרשורים היא חסרת טעם והיא לא שימושית לכל מצבי ה-API. אם מספר הבקשות גבוה מדי, קורות שגיאות במכסה.
שגיאות מבוססות זמן
בכל השגיאות שמבוססות על זמן (עד N שניות ל-X שניות לכל שרשור), במיוחד במקרה של שגיאות מסוג 503 בקוד הסטטוס, מומלץ לבדוק את החריגה. במקרה כזה, מומלץ להשתמש באלגוריתם השהיה מעריכית ולהמתין לעיכוב קל לפני שמנסים לבצע שוב את הקריאה שנכשלה. דוגמה ל-Group Migration API לשרשור אחד: להמתין 5 שניות ולנסות שוב לבצע את הקריאה שנכשלה. אם הבקשה נשלחת בהצלחה, כדאי לחזור על הדפוס הזה בשרשורים האחרים. אם הבקשה השנייה לא הצליחה, האפליקציה צריכה להתרחב בהתאם לתדירות הבקשה עד שהשיחה תסתיים. לדוגמה, אפשר להאריך את ההשהיה הראשונית
5 שניות ל-10 שניות ולנסות שוב לבצע את השיחה שנכשלה. בנוסף, החליטו על מגבלה על מספר הניסיונות החוזרים. לדוגמה, תנסו שוב לשלוח בקשה 5 עד 7 פעמים עם זמני השהיה שונים, לפני שהאפליקציה תחזיר למשתמש שגיאה.
מגבלות
| קטגוריות של מגבלות API | מגבלות |
|---|---|
| שאילתות לשנייה (QPS) | המגבלה של פרויקט הפיתוח היא 10 שאילתות לשנייה (QPS) לכל חשבון. |
מכסות
| קטגוריות של מכסות ל-API | מכסות |
|---|---|
| מספר מקסימלי של בקשות API ליום | המספר המקסימלי של בקשות API ליום הוא 500,000. |
| העברה לארכיון, תפוגה של הודעות | לארכיונים של קבוצות אין תאריך תפוגה. הודעות נשארות בארכיון עד למחיקת הקבוצה. מדיניות שמירת האימייל לא משפיעה על הודעות בארכיון של קבוצה. |
| גודל הודעת אימייל | הגודל המקסימלי של הודעת דואר הוא 25MB. המגבלה הזו כוללת את כותרות המטא-נתונים של ההודעה, את גוף ההודעה ואת כל הקבצים המצורפים. |
סוגים נוספים של מגבלות
| מגבלות אחרות | מגבלות והנחיות |
|---|---|
| פורמטים של סוג תוכן | הודעת האימייל חייבת להיות בפורמט הטקסט הסטנדרטי RFC 822.
כשמעלים הודעות אימייל שהועברו, סוג התוכן של הבקשה חייב לכלול את הכותרת Content-type: message/rfc822.
|
| פורמט הנתונים בתגובות API | פורמט הנתונים של התגובה הוא JavaScript Object Notation (JSON). |
| מדיניות בנושא מיקום נתונים | ה-Groups Migration API לא תומך במדיניות בנושא מיקום נתונים, שמחייבת אחסון של נתונים בגבולות גיאוגרפיים או פוליטיים ספציפיים מסיבות חוזיות. אל תשתמשו ב-Groups Migration API אם מיקום הנתונים נדרש עבור החשבון שלכם. |
| הכנסות הודעה מקבילות | ממשק ה-API של Groups Migration תומך בבקשות מקבילות להכנסת אימיילים לארכיונים שונים של קבוצות. אבל ה-API של Groups Migration לא תומך בהכנסה מקבילה של הודעות לאותו ארכיון קבוצתי. בנוסף, בקשות באצווה לא נתמכות בגרסה הזו של ה-API להעברת קבוצות. |
| בקשות לא מורשות | ה-API להעברת קבוצות לא מקבל בקשות לא מורשות. בקשה נחשבת לא מורשית אם לא סופק אסימון הרשאה. למידע נוסף קראו את המאמר מידע על אימות והרשאה. |