在使用 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
:电子邮件的元数据、正文和所有附件。以下是已迁移到 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
的消息将显示为已读,但对所有其他用户显示为未读。