הוספה ישירה של הודעה לתיבת הדואר של המשתמש הזה בלבד, בדומה ל-IMAP APPEND, תוך עקיפה של רוב תהליכי הסריקה והסיווג. לא נשלחת הודעה.
בקשת HTTP
- URI להעלאה, לבקשות העלאה של מדיה:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages - URI של מטא-נתונים, לבקשות של מטא-נתונים בלבד:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
userId |
זוהי כתובת האימייל של המשתמש. אפשר להשתמש בערך המיוחד |
פרמטרים של שאילתה
| פרמטרים | |
|---|---|
internalDateSource |
המקור של התאריך הפנימי של ההודעה ב-Gmail. |
deleted |
לסמן את האימייל כ'נמחק לתמיד' (לא 'אשפה') כך שרק אדמין ב-Vault יוכל לראות אותו ב-Google Vault. משמש רק לחשבונות Google Workspace. |
גוף הבקשה
גוף הבקשה מכיל מופע של Message.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Message.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://mail.google.com/https://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/gmail.insert
מידע נוסף זמין במדריך ההרשאות.