Method: users.messages.insert

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

إدراج رسالة مباشرةً في صندوق البريد الإلكتروني لهذا المستخدم فقط، مثل 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

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