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 Transcoding استفاده می کند.

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

مولفه های
userId

string

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

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

مولفه های
internalDateSource

enum ( InternalDateSource )

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

neverMarkSpam

boolean

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

processForCalendar

boolean

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

deleted

boolean

ایمیل را به‌عنوان حذف‌شده دائمی (نه TRASH) علامت‌گذاری کنید و فقط در 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

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.