تمثّل المسودات الرسائل غير المُرسَلة التي تم تطبيق تصنيف نظام "DRAFT
" عليها.
لا يمكن تعديل الرسالة الواردة في المسودة بعد إنشائها، ولكن يمكن استبدالها. وبالتالي، فإن مورد المسودة هو ببساطة حاوية توفّر معرّفًا ثابتًا لأنّ معرّفات الرسائل الأساسية تتغير في كل مرة يتم فيها استبدال الرسالة.
تتبع موارد الرسائل داخل المسودات سلوكًا مشابهًا للرسائل الأخرى، باستثناء الاختلافات التالية:
- لا يمكن أن تحتوي مسودات الرسائل على أي تصنيف غير تصنيف نظام
DRAFT
. - عند إرسال المسودة، يتم حذفها تلقائيًا ويتم إنشاء رسالة جديدة
بمعرّف معدَّل باستخدام تصنيف النظام
SENT
. يتم عرض هذه الرسالة في الردdrafts.send
.
الفهرس
إنشاء مسودات الرسائل
يمكن لتطبيقك إنشاء مسودات باستخدام طريقة drafts.create. وتتلخص العملية العامة في:
- أنشئ رسالة MIME متوافقة مع RFC 2822.
- حوِّل الرسالة إلى سلسلة base64url بترميز.
- أنشِئ مسودة مع ضبط
قيمة الحقل
drafts.message.raw
على السلسلة المشفرة.
توضح أمثلة التعليمات البرمجية التالية هذه العملية.
Java
Python
جارٍ تحديث المسودات
على غرار إنشاء مسودة، لتعديل مسودة، عليك توفير مورد Draft
في نص طلبك مع ضبط الحقل draft.message.raw
على سلسلة base64url مرمّزة تحتوي على رسالة MIME. بسبب
تعذُّر تعديل الرسائل، يتم إتلاف الرسالة المضمّنة في المسودة واستبدالها برسالة MIME الجديدة المقدَّمة في طلب التحديث.
يمكنك استرداد رسالة MIME الحالية المضمّنة في المسودة عن طريق استدعاء drafts.get
مع المعلمة format=raw
.
ولمزيد من المعلومات، يمكنك الاطّلاع على drafts.update
.
جارٍ إرسال المسودات
عند إرسال مسودة، يمكنك اختيار إرسال الرسالة كما هي أو كرسالة مُحدَّثة. في حال تعديل محتوى المسودة من خلال رسالة جديدة،
توفير مورد Draft
في نص طلب
drafts.send
، وضبط
draft.id
للمسودة المطلوب إرسالها، وضبط الحقل draft.message.raw
على
رسالة MIME الجديدة التي تم ترميزها كسلسلة base64url مشفَّرة. لمزيد من المعلومات، يُرجى الاطّلاع على drafts.send
.