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 状态代码。无效格式示例包括:

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

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

UNSUPPORTED_PARALLEL_OPERATION - Groups Migration API 不支持向同一群组归档并行插入消息。此外,Groups Migration API 不支持批量请求。不过,Groups Migration API 支持并行请求将电子邮件插入不同的群组归档。系统将返回 400 HTTP 状态代码。