Method: users.messages.import

מייבא הודעה רק לתיבת הדואר של המשתמש הזה, עם סריקה וסיווג של מסירת אימייל רגילה, בדומה לקבלה באמצעות SMTP. השיטה הזו לא מבצעת בדיקות SPF, ולכן יכול להיות שהיא לא תפעל עבור חלק מהודעות הספאם, כמו הודעות שמנסות לבצע זיוף דומיין. השיטה הזו לא שולחת הודעה. הגודל המקסימלי של ההודעה הוא 150MB.

בקשת HTTP

  • ‫URI להעלאה, לבקשות להעלאת מדיה:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • ‫URI של מטא-נתונים, לבקשות של מטא-נתונים בלבד:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
userId

string

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

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

פרמטרים
internalDateSource

enum (InternalDateSource)

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

boolean

התעלמות מההחלטה של מסווג הספאם של Gmail ואי סימון האימייל הזה כספאם בתיבת הדואר.
processForCalendar

boolean

לעבד את ההזמנות לפגישות באימייל ולהוסיף ליומן Google של המשתמש את כל הפגישות שחולצו.
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.