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

Archive: insert

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

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

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

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

בקשה

בקשת HTTP

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

פרמטרים

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

הרשאות

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

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

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

גוף הבקשה

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

תשובה

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

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

שם הנכס Value התיאור

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

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

responseCode

string

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

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

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

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

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

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

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