发送反馈
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
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 状态代码。
发送反馈
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-03-06。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
需要向我们提供更多信息?