Method: users.messages.batchDelete
根据邮件 ID 删除多封邮件。不保证消息未被删除,甚至根本不存在。
HTTP 请求
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchDelete
网址采用 gRPC 转码语法。
路径参数
参数 |
userId |
string
用户的电子邮件地址。特殊值 me 可用于指示通过身份验证的用户。
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"ids": [
string
]
} |
字段 |
ids[] |
string
要删除的消息的 ID。
|
授权范围
需要以下 OAuth 范围:
有关详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-05。
[null,null,["最后更新时间 (UTC):2024-09-05。"],[[["This endpoint allows you to delete multiple messages in Gmail by providing a list of message IDs."],["The request is sent as a POST request to a specific URL with the user's email address as a path parameter."],["The request body requires a JSON object containing an array of message IDs to be deleted."],["Although it doesn't guarantee the existence or prior deletion status of the messages, it efficiently processes bulk message deletions."],["Proper authorization with the `https://mail.google.com/` scope is necessary for successful execution."]]],[]]