לפני העברת אימייל לקבוצות Google באמצעות Groups Migration API, יש לבצע את הפעולות הבאות
- לפני שמעבירים הודעת אימייל לארכיון של הקבוצה, צריך לוודא שקבוצת היעד קיימת ושהאימייל של הקבוצה מדויק. למידע נוסף על קבוצות של כרטיסי מוצר ומשתמשים ב-Directory API.
- אם הדומיין של כתובת האימייל של השולח זהה לזה של קבוצת היעד, צריך לוודא ששולח האימייל קיים לפני שמעבירים את ההודעה לארכיון של קבוצת היעד.
- הפורמט של הודעת האימייל צריך להיות
בהגדרה הרגילה של RFC 822.
צריך להשתמש בכותרת
Content-type: message/rfc822
. מוודאים שהשדותTo:
,From:
ו-Date:
של הודעת האימייל מופיעים כראוי. התשובה מוחזרת בפורמט הנתונים JSON.
העברת הודעת אימייל לקבוצות Google
כדי להעביר הודעת אימייל לארכיון של קבוצה, צריך לשלוח בקשת HTTP מסוג POST
, לכלול את הכותרת Authorization
ולהחליף את GROUP_EMAIL_ADDRESS
בכתובת האימייל של הקבוצה שההודעות מיועדות אליה:
POST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media
בקשה לדוגמה
הדוגמה הזו מעבירה הודעות אימייל לארכיון samplegroup@googlegroups.com. הגודל של Content-Length
מוגבל ל-25MB, והוא כולל את המטא-נתונים של ההודעה, את גוף ההודעה ואת הקבצים המצורפים שלה:
POST https://www.googleapis.com/upload/groups/v1/groups/samplegroup@googlegroups.com/archive?uploadType=media
Host: www.googleapis.com
Content-Type: message/rfc822
Content-Length: BYTES
Authorization: Bearer Auth token
METADATA_BODY
מחליפים את מה שכתוב בשדות הבאים:
BYTES
: מספר הבייטים בהודעת האימייל.AUTH_TOKEN
: הכותרת Authorization
.METADATA_BODY
: המטא-נתונים של הודעת האימייל, גוף ההודעה והקבצים המצורפים אליה.בהמשך מופיעה הודעת אימייל לדוגמה בפורמט טקסט RFC 822 שהועבר לארכיון של samplegroup@googlegroups.com. NNNN@mail.samplegroup.com
הוא מזהה ההודעה
בדוגמה הזו. השולח של האימייל שהועבר הוא samplesender@example.com והאימייל
הועבר לארכיון של הקבוצה samplegroup@googlegroups.com:
Received: by 10.143.160.15 with HTTP; Mon, 16 Jul 2007 10:12:26 -0700 (PDT) Message-ID: <NNNN@mail.samplegroup.com> Date: Mon, 16 Jul 2007 10:12:26 -0700 From: samplesender@example.com To: samplegroup@googlegroups.com Subject: SUBJECT MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Content-Disposition: inline Delivered-To: samplegroup@samplegroup.com This is the body of the migrated email message.
תגובה מוצלחת מחזירה את קוד הסטטוס 200
של HTTP ואת סטטוס ההעברה.
למידע נוסף על הערכים של responseCode
, תוכלו לעיין בחומר העזר בנושא Groups Migration API.
{ "kind": "groupsMigration#groups", "responseCode": "SUCCESS", }
הצגת הודעות מיובאות בממשק של קבוצות Google
בקבוצות Google, מצב 'כבר קראתי' ו'עוד לא קראתי' של השרשור נשמר בנפרד לכל משתמש. כאשר מוסיפים הודעות ושרשורים באמצעות Groups Migration API, הם נחשבים כאילו הם נשלחו על ידי המשתמש בכותרת From:
. כלומר, הן יופיעו כהודעות שלא נקראו
אצל כל המשתמשים, מלבד המשתמש שכתובתו נמצאת בכותרת From:
. לדוגמה, אחרי הדוגמה הקודמת של בקשת ה-JSON, ההודעה SUBJECT
מופיעה כהודעה שנקראה אם samplesender@example.com
התחברה לקבוצות Google, אבל אצל כל שאר המשתמשים היא תופיע כהודעה ש'עוד לא קראתי'.