Method: users.threads.delete
立即永久删除指定会话。相应会话中的所有消息也会一并删除。此操作无法撤消。请改用 threads.trash。
HTTP 请求
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}
网址采用 gRPC 转码语法。
路径参数
| 参数 |
userId |
string
用户的电子邮件地址。特殊值 me 可用于指示经过身份验证的用户。
|
id |
string
要删除的会话的 ID。
|
响应正文
如果成功，则响应正文为空的 JSON 对象。
授权范围
需要以下 OAuth 范围：
如需了解详情，请参阅授权指南。
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-03-14。
[null,null,["最后更新时间 (UTC)：2025-03-14。"],[[["Permanently deletes a specified thread and all its associated messages, an irreversible action."],["Requires user ID and thread ID as path parameters in the DELETE request."],["Uses Gmail API and needs authorization with the `https://mail.google.com/` scope."],["Request body should be empty, and a successful deletion results in an empty response body."],["Consider using `threads.trash` for a reversible alternative to thread deletion."]]],["This document outlines how to permanently delete a Gmail thread and its associated messages via an HTTP DELETE request. The request requires specifying the `userId` (user's email, or \"me\") and the `id` of the thread. The URL follows gRPC Transcoding syntax. The request body must be empty, and a successful deletion returns an empty response. This action is irreversible. Authorization needs the `https://mail.google.com/` OAuth scope. Prefer trashing a thread over deleting it.\n"]]
