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 Transcode.

معلّمات المسار

المعلّمات
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

لمزيد من المعلومات، اطّلِع على دليل التفويض.