Method: users.messages.insert

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

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

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