依訊息 ID 刪除大量訊息。無法保證訊息未遭刪除,甚至無法保證訊息存在。
HTTP 要求
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchDelete
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
userId |
使用者的電子郵件地址。特殊值 |
要求主體
要求主體會包含結構如下的資料:
| JSON 表示法 |
|---|
{ "ids": [ string ] } |
| 欄位 | |
|---|---|
ids[] |
要刪除的訊息 ID。 |
回應主體
如果成功,回應主體會留白。
授權範圍
需要下列 OAuth 範圍:
https://mail.google.com/
詳情請參閱OAuth 2.0 Overview。