Method: users.messages.insert

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

درخواست HTTP

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

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