Method: users.messages.trash
העברת ההודעה שצוינה לאשפה.
בקשת HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/trash
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
| פרמטרים |
userId |
string
זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.
|
id |
string
המזהה של ההודעה לאשפה.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Message.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של 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 the specified message to the trash using the Gmail API."],["Requires the user's email address and the message ID as path parameters."],["An empty request body is necessary, and a successful response returns the message details."],["Needs authorization with specific OAuth scopes for modifying Gmail access."]]],["This document outlines the process for moving a message to the trash using the Gmail API. It requires a `POST` request to a specific URL: `https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/trash`. The `userId` and `id` of the message are specified in the path. The request body must be empty. Upon success, the API returns a `Message` instance. Authorization requires either `https://mail.google.com/` or `https://www.googleapis.com/auth/gmail.modify` OAuth scopes.\n"]]
