Method: users.messages.insert

إدراج رسالة مباشرةً في صندوق البريد الإلكتروني لهذا المستخدم فقط، مثل IMAP APPEND، مع تجاوز معظم عمليات المسح والتصنيف لا يتم إرسال رسالة.

طلب HTTP

  • عنوان URL لتحميل طلبات تحميل الوسائط:
    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

وضع علامة على الرسالة الإلكترونية كرسالة محذوفة نهائيًا (وليس في "المهملات") وجعلها مرئية فقط في 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

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