يوضّح هذا المستند كيفية إنشاء مسودات رسائل إلكترونية وتعديلها وإرسالها باستخدام Gmail API.
تمثّل مسودات الرسائل الإلكترونية الرسائل غير المُرسَلة التي تم تطبيق تصنيف النظام DRAFT عليها.
لا يمكن تعديل الرسالة المضمّنة في المسودة بعد إنشائها، ولكن يمكن استبدالها. بهذا المعنى، فإنّ المورد
drafts هو
حاوية توفّر معرّفًا ثابتًا لأنّ معرّفات الرسائل الأساسية تتغيّر
في كل مرة يتم فيها استبدال الرسالة.
يتشابه سلوك مورد messages
داخل مسودة مع سلوك الرسائل الأخرى باستثناء الاختلافات التالية:
- لا يمكن أن تحتوي الرسائل غير المكتملة على أي تصنيف آخر غير تصنيف النظام
DRAFT. - عند إرسال المسودة، يتم حذفها تلقائيًا وإنشاء رسالة جديدة
بمعرّف معدَّل مع تصنيف النظام
SENT. يتم عرض هذه الرسالة في ردّ الطريقةdrafts.send.
إنشاء مسودّات
يمكن لتطبيقك إنشاء مسودات باستخدام الطريقة
drafts.create. لإنشاء مسودّة، اتّبِع الخطوات التالية:
- أنشئ رسالة MIME متوافقة مع RFC 2822.
- حوِّل الرسالة إلى سلسلة مرمَّزة باستخدام base64URL.
- استدعِ طريقة
drafts.create، مع ضبط قيمة الحقلmessages.rawعلى السلسلة المرمّزة.
توضّح عيّنات الرموز البرمجية التالية هذه العملية:
جافا
Python
cURL
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/drafts' \
--header 'Authorization: Bearer ACCESS_TOKEN" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"message":{"raw":"MESSAGE"}}'
غيِّر القيم في السلسلة على الشكل التالي:
- ACCESS_TOKEN: رمز الدخول الذي يمنح الإذن بالوصول إلى واجهة برمجة التطبيقات.
- MESSAGE: رسالة MIME منسَّقة وفق RFC 2822، تم ترميزها باستخدام base64URL.
تعديل المسودّة
على غرار إنشاء مسودة، يجب تقديم drafts
مورد في نص الطلب مع ضبط الحقل messages.raw على
سلسلة مشفّرة بتنسيق base64URL تحتوي على رسالة MIME لتعديل مسودة. بما أنّه لا يمكن تعديل الرسائل، يتم إتلاف الرسالة الواردة في المسودة واستبدالها برسالة MIME الجديدة المقدَّمة في طلب التعديل.
يمكنك استرداد رسالة MIME الحالية المتضمّنة في المسودة من خلال استدعاء الطريقة drafts.get مع مَعلمة طلب البحث format=raw.
لمزيد من المعلومات، يُرجى الاطّلاع على طريقة
drafts.update.
إرسال المسودات
عند إرسال مسودة، يمكنك إرسالها كما هي أو تقديم تعديلات في طلب الإرسال.
لتعديل المسودة عند الإرسال، يجب توفير مورد drafts في نص الطلب الخاص بطريقة drafts.send. في المرجع drafts، يجب تحديد مسودة id المسودة المطلوب إرسالها وضبط الحقل messages.raw على رسالة MIME الجديدة المرمّزة كسلسلة base64URL.
للحصول على معلومات حول إرسال رسالة Gmail، يُرجى الاطّلاع على إرسال الرسائل.