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
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 状态代码。