העברת הודעות אימייל

לפני העברת אימייל לקבוצות 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, אבל אצל כל שאר המשתמשים היא תופיע כהודעה ש'עוד לא קראתי'.