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 範圍：
詳情請參閱授權指南。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-09-05 (世界標準時間)。
[null,null,["上次更新時間：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"]]
