Method: users.threads.delete
המחיקה של השרשור שצוין מתבצעת באופן מיידי וסופי. גם כל ההודעות בשרשור יימחקו. לא ניתן לבטל את הפעולה הזו. במקום זאת, מומלץ להשתמש ב-threads.trash
.
בקשת HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
userId |
string
זוהי כתובת האימייל של המשתמש. אפשר להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.
|
id |
string
המזהה של השרשור שרוצים למחוק.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-03-14 (שעון UTC).
[null,null,["עדכון אחרון: 2025-03-14 (שעון UTC)."],[[["Permanently deletes a specified thread and all its associated messages, an irreversible action."],["Requires user ID and thread ID as path parameters in the DELETE request."],["Uses Gmail API and needs authorization with the `https://mail.google.com/` scope."],["Request body should be empty, and a successful deletion results in an empty response body."],["Consider using `threads.trash` for a reversible alternative to thread deletion."]]],["This document outlines how to permanently delete a Gmail thread and its associated messages via an HTTP DELETE request. The request requires specifying the `userId` (user's email, or \"me\") and the `id` of the thread. The URL follows gRPC Transcoding syntax. The request body must be empty, and a successful deletion returns an empty response. This action is irreversible. Authorization needs the `https://mail.google.com/` OAuth scope. Prefer trashing a thread over deleting it.\n"]]