ממשק API להעברת קבוצות: מגבלות ומכסות
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מגבלות ומכסות מגינות על התשתית של 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 להעברת קבוצות לא מקבל בקשות לא מורשות. בקשה נחשבת לא מורשית אם לא סופק אסימון הרשאה. למידע נוסף קראו את המאמר מידע על אימות והרשאה.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-29 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Groups Migration API: limits and quotas\n\nLimits and quotas protect the Google infrastructure from an automated process that uses the\nGroups Migration API in an inappropriate way. Excessive requests from an API might result from a\nharmless typo, or from an inefficiently designed system that makes needless API calls. Regardless of\nthe cause, blocking traffic from a specific source once it reaches a certain level is necessary for\nthe overall health of the Google Workspace system.\n\nAPI request failures\n--------------------\n\nIn the unlikely event that your API request fails, your application receives an HTTP status code\nresponse. An HTTP status code of `403` has error information about incorrect input, and\nan HTTP status code of `503` has error information indicating which API quotas have been\nexceeded. These responses let your custom application detect these errors and take appropriate\naction.\n\nTime sensitive requests\n-----------------------\n\nIf your requests need to be completed in a fixed period of time, send your requests in parallel\nor use multiple threads in your Java or C# application. For example, break your requests by month or\nanother time period. In the case of threads, try starting with 10 threads, one thread per request.\nThe thread recommendation has trade-offs and isn't useful for all API situations. If the number of\nrequests gets too high, quota errors occur.\n\nTime-based errors\n-----------------\n\nFor all errors that are time based (maximum of N things for X seconds per thread), especially the\n`503` status code errors, we recommend that your code catch the exception and, by using\nan\n[exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff)\nalgorithm, wait for a small delay before retrying the failed call. A Groups Migration API example for\none thread is to wait 5 seconds and retry the failed call. If the request is successful, repeat this\npattern for the other threads. If the second request isn't successful, your application should scale\nback on the frequency of the request until a call is successful. For example, increase the initial\n5 second delay to 10 seconds and retry your failed call again. Also, decide on a retry limit. For \\]\nexample, retry a request 5 to 7 times with different delay times before your application returns an\nerror to the user.\n\nLimits\n------\n\n| API limit categories | Limits |\n|--------------------------|-------------------------------------------------------------------------|\n| Queries per second (QPS) | The developer project limit is 10 queries per second (QPS) per account. |\n\nQuotas\n------\n\n| API quota categories | Quotas |\n|---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Maximum API requests per day | The maximum API requests per day is 500,000. |\n| Archive, expiration of messages | Group archives don't expire. Messages remain in an archive until the group is deleted. The email retention policy doesn't affect messages in a group's archive. |\n| Mail message size | The maximum mail message size is 25MB. This limit includes the message's meta data headers, body, and any attachments. |\n\nOther types of limits\n---------------------\n\n| Other limits | Limitations and guidelines |\n|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Content type formats | An email message must be in the standard [RFC 822 text format](https://www.w3.org/Protocols/rfc822/). When uploading migrated emails, a request's content type must use the `Content-type: message/rfc822` header. |\n| Data format in API responses | The response's data format is JavaScript Object Notation ([JSON](https://json.org/)). |\n| Data location policies | The Groups Migration API doesn't support data location policies requiring data to be stored in specific geographic or political boundaries for contractual reasons. Don't use the Groups Migration API if data location is required for your account. |\n| Parallel message insertions | The Groups Migration API supports parallel requests for email insertions into different group archives. But the Groups Migration API doesn't support parallel message insertions into the same group archive. Also batch requests aren't supported in this version of the Groups Migration API. |\n| Unauthorized requests | The Groups Migration API doesn't accept any unauthorized requests. A request is considered unauthorized if no authorization token is provided. For more information, see [Learn about authentication \\& authorization](/workspace/guides/auth-overview). |"]]
