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

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