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

לפני שמעבירים אימייל ל-Google Groups באמצעות Groups Migration API, צריך לבצע את הפעולות הבאות:

  • לפני שמעבירים הודעת אימייל לארכיון של קבוצה מסוימת, צריך לוודא שהקבוצה קיימת ושהאימייל שלה מדויק. מידע נוסף על רישום קבוצות ומשתמשים זמין ב-Directory API.
  • אם השולח של האימייל הוא מאותו דומיין כמו קבוצת היעד, צריך לוודא שכתובת האימייל של השולח קיימת לפני העברת הודעת האימייל לארכיון של קבוצת היעד.
  • הפורמט של הודעת האימייל צריך להיות בהתאם להגדרה של תקן RFC 822. משתמשים בכותרת Content-type: message/rfc822. מוודאים שהפורמט של השדות To:, From: ו-Date: בהודעת האימייל תקין. התגובה מוחזרת בפורמט הנתונים JSON.

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

כדי להעביר הודעת אימייל לארכיון של קבוצה, שולחים POST בקשת HTTP, כוללים את הכותרת 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 מופיע במאמר מאמרי העזרה של ה-API להעברת קבוצות.

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

איך רואים הודעות מיובאות בממשק של קבוצות Google

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