Method: users.messages.insert

• בקשת HTTP
• פרמטרים של נתיב
• פרמטרים של שאילתה
• גוף הבקשה
• גוף התשובה
• היקפי הרשאות
• רוצים לנסות?

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

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