يتم إدراج رسالة مباشرةً في صندوق البريد الإلكتروني لهذا المستخدم الذي يشبه 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 |
عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة |
معامِلات طلب البحث
المعلّمات | |
---|---|
internalDateSource |
مصدر للتاريخ الداخلي للرسالة في Gmail |
deleted |
ضع علامة على الرسالة الإلكترونية كمحذوفة نهائيًا (وليست 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
لمزيد من المعلومات، اطّلِع على دليل التفويض.