Method: users.drafts.delete
מוחק באופן מיידי ולצמיתות את הטיוטה שצוינה. לא סתם מעבירים אותו לאשפה.
בקשת HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
| פרמטרים |
userId |
string
זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.
|
id |
string
המזהה של הטיוטה למחיקה.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הביצוע יהיה תקין, גוף התגובה יהיה ריק.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.compose
למידע נוסף, ניתן לעיין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-05 (שעון UTC).
[null,null,["עדכון אחרון: 2024-09-05 (שעון UTC)."],[[["Permanently deletes the specified draft, distinguished from simply trashing it."],["Employs an HTTP DELETE request to `https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}` with path parameters for user and draft ID."],["Requires an empty request body and returns an empty response body upon successful deletion."],["Needs authorization with specific OAuth scopes including `https://mail.google.com/`, `https://www.googleapis.com/auth/gmail.modify`, or `https://www.googleapis.com/auth/gmail.compose`."]]],["This document outlines the process for permanently deleting a Gmail draft via an HTTP DELETE request. The endpoint is `https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}`, with `userId` and `id` as path parameters. `userId` represents the user's email, or `me`, while `id` is the draft's ID. The request body must be empty, and a successful response also returns an empty body. Authorization requires one of three specified OAuth scopes.\n"]]
