迁移电子邮件

在使用 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 是此示例的邮件 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 群组,但显示为未读 所有其他用户