根据消息 ID 删除多封邮件。无法保证消息尚未被删除,甚至无法保证消息是否存在。
HTTP 请求
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchDelete
网址采用 gRPC 转码语法。
路径参数
| 参数 | |
|---|---|
| userId | 
 用户的电子邮件地址。特殊值  | 
请求正文
请求正文中包含结构如下的数据:
| JSON 表示法 | 
|---|
| { "ids": [ string ] } | 
| 字段 | |
|---|---|
| ids[] | 
 要删除的消息的 ID。 | 
响应正文
如果成功,则响应正文为空。
授权范围
需要以下 OAuth 范围:
- https://mail.google.com/
如需了解详情,请参阅授权指南。