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 Transcoding.

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

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

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

פרמטרים
internalDateSource	enum (InternalDateSource) המקור של התאריך הפנימי של ההודעה ב-Gmail.
deleted	boolean לסמן את האימייל כמחוק באופן סופי (לא באשפה) וכגלוי רק ב-Google Vault לאדמין של Vault. האפשרות הזו זמינה רק בחשבונות Google Workspace.

גוף הבקשה

גוף הבקשה מכיל מופע של Message.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Message.

היקפי הרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

• https://mail.google.com/
• https://www.googleapis.com/auth/gmail.modify
• https://www.googleapis.com/auth/gmail.insert

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.