迁移电子邮件

在使用 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:电子邮件的元数据、正文和所有附件。
  • 以下是已迁移到 samplegroup@googlegroups.com 归档的 RFC 822 文本格式电子邮件示例。NNNN@mail.samplegroup.com 是此示例的邮件 ID。迁移的电子邮件的发件人为 sampleender@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 的消息将显示为已读,但对所有其他用户显示为未读。