Method: users.drafts.delete
מחיקת הטיוטה שצוינה באופן מיידי וסופי. לא פשוט מוחק אותו.
בקשת HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts/{id}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
userId |
string
זוהי כתובת האימייל של המשתמש. אפשר להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.
|
id |
string
המזהה של הטיוטה שרוצים למחוק.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של 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 ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-03-14 (שעון UTC).
[null,null,["עדכון אחרון: 2025-03-14 (שעון 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"]]