Method: users.messages.insert

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

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

مولفه های
userId

string

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

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

مولفه های
internalDateSource

enum ( InternalDateSource )

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

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

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