遷移電子郵件

使用 Groups Migration API 將電子郵件遷移至 Google 討論群組之前，請先完成下列步驟：

  • 將電子郵件訊息遷移至目標群組的封存資料夾前，請先確認目標群組存在，且群組的電子郵件地址正確無誤。如要進一步瞭解如何列出群組和使用者，請參閱 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 的大小上限為 25 MB，包括郵件的 中繼資料、內文和所有附件：

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 值，請參閱群組遷移 API 參考資料。

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

在 Google 網路論壇介面中查看匯入的郵件

在 Google 討論群組中，系統會為每位使用者分別儲存討論串的已讀或未讀狀態。使用 Google 網路論壇遷移 API 插入訊息和討論串時，系統會將這些內容視為由 From: 標頭中的使用者傳送。也就是說，除了地址位於 From: 標頭的使用者以外，所有使用者都會看到未讀郵件。舉例來說，在先前的 JSON 要求範例之後，如果 samplesender@example.com 登入 Google 網路論壇，系統會將標題為 SUBJECT 的郵件標示為已讀，但其他使用者會看到該郵件標示為未讀。