遷移電子郵件

使用 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_TOKENAuthorization 標頭。
  • 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 要求範例之後,如果 samplesender@example.com 登入 Google 群組,標題為 SUBJECT 的訊息就會顯示為已讀取,但對所有其他使用者顯示為未讀取。