Method: users.threads.trash
העברת השרשור שצוין לאשפה. גם ההודעות ששייכות לשרשור יועברו לאשפה.
בקשת HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/trash
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
| פרמטרים |
userId |
string
זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.
|
id |
string
המזהה של השרשור לאשפה.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Thread.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
למידע נוסף, ניתן לעיין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-05 (שעון UTC).
[null,null,["עדכון אחרון: 2024-09-05 (שעון UTC)."],[[["Moves a specified thread and its associated messages to the trash."],["Requires the user's email address (`userId`) and the thread ID (`id`) as path parameters."],["Uses an empty request body and returns a `Thread` object upon successful completion."],["Needs authorization with either `https://mail.google.com/` or `https://www.googleapis.com/auth/gmail.modify` scope."]]],["This document outlines the process for moving a Gmail thread to the trash via an API. The `POST` request to `https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}/trash` requires two path parameters: `userId` (user's email, or \"me\") and `id` (thread ID). The request body must be empty. Upon success, the response contains thread details. Authorization requires either `https://mail.google.com/` or `https://www.googleapis.com/auth/gmail.modify` OAuth scope.\n"]]
