Method: users.messages.send
שולח את ההודעה שצוינה לנמענים בכותרות To, Cc ו-Bcc. לדוגמה שימוש, ראה שליחת אימייל.
בקשת HTTP
- יש להעלות URI, עבור בקשות להעלאת מדיה:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/send
- URI של מטא-נתונים, לבקשות למטא-נתונים בלבד:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/send
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
| פרמטרים |
userId |
string
זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.
|
גוף הבקשה
גוף הבקשה מכיל מופע של Message.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Message.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.compose
https://www.googleapis.com/auth/gmail.send
למידע נוסף, ניתן לעיין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-05 (שעון UTC).
[null,null,["עדכון אחרון: 2024-09-05 (שעון UTC)."],[[["This API endpoint allows sending emails to specified recipients using the `To`, `Cc`, and `Bcc` headers, with usage examples available in the Sending email guide."],["It accepts HTTP POST requests to either upload media or send metadata, utilizing gRPC Transcoding syntax and requiring a `userId` path parameter representing the sender's email address."],["The request body should contain a `Message` object defining the email content, and a successful response will return the sent `Message` object."],["Authorization is required using one of the listed OAuth scopes, including `https://mail.google.com/` or those granting Gmail modification, composing, or sending permissions."]]],[]]
