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 משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
userId	string זוהי כתובת האימייל של המשתמש. אפשר להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.

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

פרמטרים
internalDateSource	enum (InternalDateSource) המקור של התאריך הפנימי של ההודעה ב-Gmail.
deleted	boolean לסמן את האימייל כ'נמחק לתמיד' (לא 'אשפה') כך שרק אדמין ב-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

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