此页面由 Cloud Translation API 翻译。

Archive: insert

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

此方法支持 /upload URI，并接受包含以下参数的已上传媒体特征：

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

Groups Migration API 的项目限制为每秒 10 次查询 (QPS) 。每天的最大 API 请求数为 50 万次。如需详细了解 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` 字段。如果 message 不是以 CR+LF（即 `"\r\n"`）样式换行符结束。电子邮件为空。迁移的目标组不存在或处于“只读”状态模式。有关有关只读共享模式的信息，请参阅 Google Groups for Business 分享选项。 `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 字段。
如果 message 不是以 CR+LF（即 "\r\n"）样式换行符结束。
电子邮件为空。
迁移的目标组不存在或处于“只读”状态模式。有关有关只读共享模式的信息，请参阅 Google Groups for Business 分享选项。

SUCCESS，表示邮件已成功在账号的群组中归档归档。系统将返回 200 HTTP 状态代码。

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