מוסיף הודעה ישירות לתיבת הדואר של המשתמש הזה בלבד בדומה ל-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 נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
userId |
זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד |
פרמטרים של שאילתה
פרמטרים | |
---|---|
internalDateSource |
מקור לתאריך הפנימי של ההודעה ב-Gmail. |
deleted |
מסמנים את האימייל כאימייל שנמחק באופן סופי (לא TRASH) ולאדמין של Vault יש אפשרות לראות אותו רק ב-Google Vault. לשימוש בחשבונות Google Workspace בלבד. |
גוף הבקשה
גוף הבקשה מכיל מופע של Message
.
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Message
.
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.insert
למידע נוסף, ניתן לעיין במדריך ההרשאות.