Method: users.messages.import

پیامی را فقط به صندوق پستی این کاربر وارد می‌کند، با اسکن و طبقه‌بندی استاندارد ارسال ایمیل مشابه دریافت از طریق SMTP. این روش بررسی‌های SPF را انجام نمی‌دهد، بنابراین ممکن است برای برخی از پیام‌های اسپم، مانند پیام‌هایی که سعی در انجام جعل دامنه دارند، کار نکند. این روش پیامی ارسال نمی‌کند. توجه داشته باشید که حداکثر اندازه پیام ۱۵۰ مگابایت است.

درخواست HTTP

  • آپلود URI، برای درخواست‌های آپلود رسانه:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • آدرس URL فراداده، برای درخواست‌های فقط فراداده:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
userId

string

آدرس ایمیل کاربر. مقدار ویژه me می‌تواند برای نشان دادن کاربر احراز هویت شده استفاده شود.

پارامترهای پرس و جو

پارامترها
internalDateSource

enum ( InternalDateSource )

منبع تاریخ داخلی جیمیل برای پیام.

neverMarkSpam

boolean

تصمیم طبقه‌بندی هرزنامه جیمیل را نادیده بگیرید و هرگز این ایمیل را به عنوان هرزنامه در صندوق پستی علامت‌گذاری نکنید.

processForCalendar

boolean

دعوت‌نامه‌های تقویم را در ایمیل پردازش کنید و جلسات استخراج‌شده را برای این کاربر به تقویم گوگل اضافه کنید.

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 .