Method: users.messages.delete
Xoá vĩnh viễn và ngay lập tức thư đã chỉ định. Bạn không huỷ được thao tác này sau khi thực hiện. Thay vào đó, hãy sử dụng messages.trash
.
Yêu cầu HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Thông số |
userId |
string
Địa chỉ email của người dùng. Bạn có thể sử dụng giá trị đặc biệt me để cho biết người dùng đã được xác thực.
|
id |
string
Mã của thư cần xoá.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ là một đối tượng JSON trống.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-03-14 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-03-14 UTC."],[[["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"]]