Method: users.messages.import

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

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

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

פרמטרים
userId

string

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

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

פרמטרים
internalDateSource

enum (InternalDateSource)

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

boolean

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

boolean

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

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