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 بنية تحويل الترميز إلى 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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.