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

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

    בתגובה מוצלחת מוחזר קוד סטטוס HTTP‏ 200 וסטטוס ההעברה. מידע נוסף על הערכים של responseCode זמין בכתובת מאמרי העזרה של Groups Migration API.

    {
 "kind": "groupsMigration#groups",
 "responseCode": "SUCCESS",
}

    הצגת הודעות שיובאו בממשק של קבוצות Google

    בקבוצות Google, שרשורים מצב 'קריאה/לא נקראה' מאוחסן בנפרד לכל משתמש. כשאתם מוסיפים הודעות וסרטונים באמצעות Groups Migration API, המערכת מתייחסת אליהם כאילו המשתמש שלח אותם בכותרת From:. זה אומר שהם מופיעים כפריטים שעוד לא קראת לכל המשתמשים, חוץ מהמשתמש שהכתובת שלו נמצאת בכותרת From:. לדוגמה, אחרי הדוגמה הקודמת לבקשת JSON, ההודעה SUBJECT נראית כהודעה שנקראה אם samplesender@example.com מחובר לקבוצות Google, אבל מופיע כלא נקרא לכל המשתמשים האחרים.