Method: users.messages.delete
立即永久删除指定消息。此操作无法撤消。建议改用 messages.trash。
HTTP 请求
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}
网址采用 gRPC 转码语法。
路径参数
| 参数 |
userId |
string
用户的电子邮件地址。特殊值 me 可用于指示经过身份验证的用户。
|
id |
string
要删除的消息的 ID。
|
授权范围
需要以下 OAuth 作用域：
有关详情，请参阅授权指南。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2024-09-05。
[null,null,["最后更新时间 (UTC)：2024-09-05。"],[[["Permanently deletes a specified message, an irreversible action."],["Requires user ID and message ID to execute."],["Uses an empty request body and returns an empty response body upon success."],["Needs authorization with the `https://mail.google.com/` scope."]]],["The core actions are to permanently delete a specified message using a `DELETE` HTTP request. The request URL structure requires `userId` (user's email, \"me\" for authenticated user) and `id` (message ID) as path parameters. The request body must be empty. A successful deletion returns an empty response body. The process needs authorization via the `https://mail.google.com/` OAuth scope. It is stated that the `messages.trash` is a preferred method than deleting.\n"]]
