Method: users.messages.insert

مستقیماً پیامی را فقط در صندوق پستی این کاربر وارد می‌کند، مشابه IMAP APPEND ، و از اکثر اسکن‌ها و طبقه‌بندی‌ها عبور می‌کند. پیامی ارسال نمی‌کند.

درخواست HTTP

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

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

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

پارامترها
userId

string

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

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

پارامترها
internalDateSource

enum ( InternalDateSource )

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

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 .