迁移电子邮件

在通过 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 值，请参阅 Groups Migration API 参考文档。

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

在 Google 群组界面中查看导入的邮件

在 Google 群组中，系统会为每位用户单独存储帖子的已读或未读状态。使用 Groups Migration API 插入消息和线程时，系统会将其视为由 From: 标头中的用户发送。这意味着，除了地址位于 From: 标头中的用户之外，所有用户都会看到这些邮件显示为未读。例如，在执行上一个 JSON 请求示例后，如果用户 samplesender@example.com 登录到 Google 群组，则标题为 SUBJECT 的消息会显示为已读，但对于所有其他用户，该消息会显示为未读。