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.

مَعلمات المسار

المَعلمات
userId

string

عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت مصادقته.

معلمات طلب البحث

المَعلمات
internalDateSource

enum (InternalDateSource)

مصدر التاريخ الداخلي للرسالة في Gmail.

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

لمزيد من المعلومات، راجِع دليل التفويض.