此页面由 Cloud Translation API 翻译。

Archive: insert

使用媒体上传功能将电子邮件迁移到 Google 网上论坛的归档。

此方法支持 /upload URI，并接受已上传且具有以下特征的媒体：

文件大小上限：邮件的大小上限为 25MB。此限制包括邮件的元数据标头、正文和所有附件。
接受的媒体 MIME 类型： message/rfc822

Groups Migration API 的项目限制为每个帐号每秒 10 次查询 (QPS)。每天的最大 API 请求数为 500,000。如需详细了解 RFC822 格式，请参阅 RFC822 标准格式。

请求

HTTP 请求

POST https://www.googleapis.com/upload/groups/v1/groups/groupId/archive?uploadType=media

参数

参数名称	值	说明
路径参数
`groupId`	`string`	将迁移的电子邮件归档到的群组的电子邮件地址。此电子邮件地址是请求网址路径中的一个变量。如果群组所有者使用管理控制台或 Directory API 更改群组的电子邮件地址，您必须在 `groupId` 变量中使用新电子邮件地址。
必需的查询参数
`uploadType`	`string`	针对 `/upload` URI 的上传请求的上传类型，具有以下某个值： `media` - 用于上传媒体数据的简单上传方法。 `resumable` - 可续传上传，使用至少两个请求系列以可续传方式上传文件。

授权

此请求需要获得以下范围的授权：

范围
`https://www.googleapis.com/auth/apps.groups.migration`

如需了解详情，请参阅身份验证和授权页面。

请求正文

不要使用此方法提供请求正文。

响应

如果成功，此方法将返回采用以下结构的响应正文：

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}

属性名称值说明

kind string 这是插入资源的种类。值：groupsmigration#groups

属性名称	值	说明
`kind`	`string`	这是插入资源的种类。值：`groupsmigration#groups`
`responseCode`	`string`	迁移请求的 API 响应状态代码以及 HTTP 状态代码。`responseCode` 状态值包括： `AUTHORIZATION FAILURE` - 表示管理员的授权凭据无效。系统会返回 `401` HTTP 状态代码。 `BACKEND FAILURE` - 表示服务器出现问题或正忙。系统会返回 `503` HTTP 状态代码。如果使用指数退避算法算法，请等待一小段延迟，然后再重试失败的调用。 `INVALID MESSAGE FAILURE` - 表示电子邮件的格式无效。如果消息因格式错误而被拒绝，您会收到 `400 Bad Request` HTTP 状态代码。无效格式示例如下：邮件可能缺少 `From`、`To` 和 `Date` 字段。如果消息中的某一行没有以 CR+LF（即 `"\r\n"`）样式的换行符终止，则会发生错误。该电子邮件消息为空。迁移的目标群组不存在或处于“只读”模式。如需详细了解只读共享模式，请参阅 Google 网上论坛企业版的共享选项。 `SUCCESS` - 表示邮件已成功归档到帐号的群组归档中。系统会返回 `200` HTTP 状态代码。 `UNSUPPORTED_PARALLEL_OPERATION` - Groups Migration API 不支持在同一群组归档中并行插入消息。此外，Groups Migration API 也不支持批量请求。但是，Groups Migration API 支持同时请求将电子邮件插入不同的群组归档。系统会返回 `400` HTTP 状态代码。

responseCode

string

迁移请求的 API 响应状态代码以及 HTTP 状态代码。responseCode 状态值包括：

AUTHORIZATION FAILURE - 表示管理员的授权凭据无效。系统会返回 401 HTTP 状态代码。

BACKEND FAILURE - 表示服务器出现问题或正忙。系统会返回 503 HTTP 状态代码。如果使用指数退避算法算法，请等待一小段延迟，然后再重试失败的调用。

INVALID MESSAGE FAILURE - 表示电子邮件的格式无效。如果消息因格式错误而被拒绝，您会收到 400 Bad Request HTTP 状态代码。无效格式示例如下：

邮件可能缺少 From、To 和 Date 字段。
如果消息中的某一行没有以 CR+LF（即 "\r\n"）样式的换行符终止，则会发生错误。
该电子邮件消息为空。
迁移的目标群组不存在或处于“只读”模式。如需详细了解只读共享模式，请参阅 Google 网上论坛企业版的共享选项。

SUCCESS - 表示邮件已成功归档到帐号的群组归档中。系统会返回 200 HTTP 状态代码。

UNSUPPORTED_PARALLEL_OPERATION - Groups Migration API 不支持在同一群组归档中并行插入消息。此外，Groups Migration API 也不支持批量请求。但是，Groups Migration API 支持同时请求将电子邮件插入不同的群组归档。系统会返回 400 HTTP 状态代码。