Method: users.messages.insert

מוסיף הודעה ישירות לתיבת הדואר של המשתמש הזה בלבד בדומה ל-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

string

זוהי כתובת האימייל של המשתמש. ניתן להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.

פרמטרים של שאילתה

פרמטרים
internalDateSource

enum (InternalDateSource)

מקור לתאריך הפנימי של ההודעה ב-Gmail.

deleted

boolean

מסמנים את האימייל כאימייל שנמחק באופן סופי (לא 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

למידע נוסף, ניתן לעיין במדריך ההרשאות.