דף זה תורגם על ידי Cloud Translation API.

Archive: insert

העברת הודעת אימייל לארכיון של קבוצת Google באמצעות העלאת מדיה.

השיטה הזו תומכת ב-URI של /upload ומקבלת מדיה שהועלתה עם המאפיינים הבאים:

גודל קובץ מקסימלי: גודל ההודעה המקסימלי באימייל הוא 25MB. המגבלה הזו כוללת את כותרות המטא-נתונים של ההודעה, את גוף ההודעה ואת כל הקבצים המצורפים אליה.
סוגי ה-MIME המותרים של מדיה: message/rfc822

מגבלת הפרויקט ב-Groups Migration API היא 10 שאילתות לשנייה (QPS) לכל חשבון. מספר הבקשות המקסימלי ל-API ליום הוא 500,000. מידע נוסף על הפורמט RFC822 זמין במאמר הפורמט הסטנדרטי RFC822.

בקשה

בקשת HTTP

POST https://www.googleapis.com/upload/groups/v1/groups/groupId/archive?uploadType=media

פרמטרים

שם הפרמטר	ערך	תיאור
פרמטרים של נתיב
`groupId`	`string`	כתובת האימייל של הקבוצה שבה יועברו לארכיון האימיילים שהועברו. כתובת האימייל הזו היא משתנה בנתיב של כתובת ה-URL של הבקשה. אם הבעלים של הקבוצה ישנה את כתובת האימייל של הקבוצה באמצעות מסוף Admin או Directory API, צריך להשתמש בכתובת האימייל החדשה במשתנה `groupId`.
פרמטרים נדרשים של שאילתות
`uploadType`	`string`	סוג הבקשה להעלאה ל-URI של `/upload` עם אחד מהערכים הבאים: `media` – העלאה פשוטה של נתוני המדיה. `resumable` – העלאה שניתן להמשיך שמעלה את הקובץ שניתן להמשיך, באמצעות סדרה של שתי בקשות לפחות.

אישור

הבקשה הזו מחייבת הרשאה עם ההיקף הבא:

היקף
`https://www.googleapis.com/auth/apps.groups.migration`

למידע נוסף, קראו את הדף אימות והרשאה.

גוף הבקשה

אל תספקו גוף בקשה בשיטה הזו.

תשובה

אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר גוף תגובה עם המבנה הבא:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}

שם הנכס ערך תיאור

kind string סוג משאב ההוספה. ערך: groupsmigration#groups

שם הנכס	ערך	תיאור
`kind`	`string`	סוג משאב ההוספה. ערך: `groupsmigration#groups`
`responseCode`	`string`	קוד הסטטוס של תגובת ה-API לבקשת ההעברה, יחד עם קוד הסטטוס של ה-HTTP. ערכים אפשריים של `responseCode`: `AUTHORIZATION FAILURE` – פרטי הכניסה של האדמין לא תקפים. קוד הסטטוס HTTP `401` מוחזר. `BACKEND FAILURE` – יש בעיה בשרת או שהוא עסוק. קוד הסטטוס `503`‏ HTTP מוחזר. באמצעות אלגוריתם השהיה מעריכית לפני ניסיון חוזר (exponential backoff), צריך להמתין לעיכוב קטן לפני שמנסים שוב את הקריאה שנכשלה. `INVALID MESSAGE FAILURE` – הודעת האימייל בפורמט לא תקין. אם הודעה נדחית כי היא לא תקינה, מקבלים קוד מצב HTTP‏ `400 Bad Request`. דוגמאות לפורמטים לא חוקיים: יכול להיות שחסרים בהודעה השדות `From`,‏ `To` ו-`Date`. אם שורה ב-message לא מסתיימת בסמל של שורה חדשה בסגנון CR+LF (כלומר `"\r\n"`), מתרחשת שגיאה. הודעת האימייל ריקה. קבוצת היעד של ההעברה לא קיימת או שהיא מוגדרת במצב 'קריאה בלבד'. מידע נוסף על שיתוף בקריאה בלבד זמין במאמר אפשרויות השיתוף ב-Google Groups for Business. `SUCCESS` – האימייל הועבר לארכיון של הקבוצה בחשבון. מוחזר קוד מצב HTTP `200`. `UNSUPPORTED_PARALLEL_OPERATION` – ‏Groups Migration API לא תומך בהוספת הודעות במקביל לאותו ארכיון קבוצתי. בנוסף, API להעברת קבוצות לא תומך בבקשות באצווה. עם זאת, ה-API להעברת קבוצות תומך בבקשות מקבילות להכנסת אימיילים לארכיונים שונים של קבוצות. מוחזר קוד מצב HTTP `400`.

responseCode

string

קוד הסטטוס של תגובת ה-API לבקשת ההעברה, יחד עם קוד הסטטוס של ה-HTTP. ערכים אפשריים של responseCode:

AUTHORIZATION FAILURE – פרטי הכניסה של האדמין לא תקפים. קוד הסטטוס HTTP 401 מוחזר.

BACKEND FAILURE – יש בעיה בשרת או שהוא עסוק. קוד הסטטוס 503‏ HTTP מוחזר. באמצעות אלגוריתם השהיה מעריכית לפני ניסיון חוזר (exponential backoff), צריך להמתין לעיכוב קטן לפני שמנסים שוב את הקריאה שנכשלה.

INVALID MESSAGE FAILURE – הודעת האימייל בפורמט לא תקין. אם הודעה נדחית כי היא לא תקינה, מקבלים קוד מצב HTTP‏ 400 Bad Request. דוגמאות לפורמטים לא חוקיים:

יכול להיות שחסרים בהודעה השדות From,‏ To ו-Date.
אם שורה ב-message לא מסתיימת בסמל של שורה חדשה בסגנון CR+LF (כלומר "\r\n"), מתרחשת שגיאה.
הודעת האימייל ריקה.
קבוצת היעד של ההעברה לא קיימת או שהיא מוגדרת במצב 'קריאה בלבד'. מידע נוסף על שיתוף בקריאה בלבד זמין במאמר אפשרויות השיתוף ב-Google Groups for Business.

SUCCESS – האימייל הועבר לארכיון של הקבוצה בחשבון. מוחזר קוד מצב HTTP 200.

UNSUPPORTED_PARALLEL_OPERATION – ‏Groups Migration API לא תומך בהוספת הודעות במקביל לאותו ארכיון קבוצתי. בנוסף, API להעברת קבוצות לא תומך בבקשות באצווה. עם זאת, ה-API להעברת קבוצות תומך בבקשות מקבילות להכנסת אימיילים לארכיונים שונים של קבוצות. מוחזר קוד מצב HTTP 400.