تمثل المسودات الرسائل غير المُرسَلة والتي تم تطبيق تصنيف النظام 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
.