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 נעשה שימוש בתחביר המרת gRPC.

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

פרמטרים
userId

string

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

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

פרמטרים
internalDateSource

enum (InternalDateSource)

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

boolean

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

boolean

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

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