Class GmailDraft

GmailDraft

مسودة رسالة أنشأها المستخدم في حسابه على Gmail

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
deleteDraft()	void	لحذف رسالة المسودة هذه
getId()	String	تعرض هذه الطريقة معرّف الرسالة في المسودّة.
getMessage()	GmailMessage	تعرض هذه الدالة GmailMessage يمثّل هذه المسودة.
getMessageId()	String	تعرِض هذه السمة رقم تعريف GmailMessage الذي يمثّل هذه المسودّة.
send()	GmailMessage	يرسِل هذا الزر مسودة الرسالة الإلكترونية.
update(recipient, subject, body)	GmailDraft	يستبدل محتوى هذه الرسالة المسودّة.
update(recipient, subject, body, options)	GmailDraft	يستبدل محتوى رسالة المسودة هذه باستخدام وسيطات اختيارية.

مستندات تفصيلية

deleteDraft()

لحذف رسالة المسودة هذه

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
draft.deleteDraft();
draft.getMessage();  // Throws exception.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة REST API ذات الصلة:

• https://mail.google.com/

---

getId()

تعرض هذه الطريقة معرّف الرسالة في المسودّة.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const draftId = draft.getId();
const draftById = GmailApp.getDraft(draftId);
Logger.log(
    draft.getMessage().getSubject() === draftById.getMessage().getSubject(),
);

الإرجاع

‫String: رقم تعريف المسودة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة REST API ذات الصلة:

• https://mail.google.com/

---

getMessage()

تعرض هذه الدالة GmailMessage يمثّل هذه المسودة.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const message = draft.getMessage();
Logger.log(message.getSubject());

الإرجاع

‫GmailMessage: الرسالة التي تمثّل محتوى هذه المسودة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة REST API ذات الصلة:

• https://mail.google.com/

---

getMessageId()

تعرِض هذه السمة رقم تعريف GmailMessage الذي يمثّل هذه المسودّة.

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const messageId = draft.getMessageId();
Logger.log(messageId === draft.getMessage().getId());

الإرجاع

String: معرّف الرسالة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة REST API ذات الصلة:

• https://mail.google.com/

---

send()

يرسِل هذا الزر مسودة الرسالة الإلكترونية. يتم تحديد الحصة لحجم الرسالة الإلكترونية (بما في ذلك العناوين).

const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const msg = draft.send();     // Send it
Logger.log(msg.getDate());    // Should be approximately the current timestamp

الإرجاع

GmailMessage: الرسالة التي تم إرسالها حديثًا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة REST API ذات الصلة:

• https://mail.google.com/

---

update(recipient, subject, body)

يستبدل محتوى هذه الرسالة المسودّة. يتم تحديد الحصة لحجم الرسالة الإلكترونية (بما في ذلك العناوين).

// The code below will update a draft email with the current date and time.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const now = new Date();
draft.update(
    '[e-mail]',
    'current time',
    `The time is: ${now.toString()}`,
);

المَعلمات

الاسم	النوع	الوصف
recipient	String	قائمة بعناوين البريد الإلكتروني مفصولة بفواصل
subject	String	موضوع الرسالة الإلكترونية (250 حرفًا كحد أقصى)
body	String	نص الرسالة الإلكترونية

الإرجاع

GmailDraft: المسودّة المعدَّلة حديثًا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة REST API ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• GmailApp.createDraft(recipient, subject, body)

---

update(recipient, subject, body, options)

يستبدل محتوى رسالة المسودة هذه باستخدام وسيطات اختيارية. يمكن أن تتضمّن الرسالة الإلكترونية نصًا عاديًا أو نص HTML. يتم تحديد الحصة لحجم الرسالة الإلكترونية (بما في ذلك العناوين).

// Update a draft email with a file from Google Drive attached as a PDF.
const draft =
    GmailApp.getDrafts()[0];  // The first draft message in the drafts folder
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
draft.update(
    '[e-mail]',
    'Attachment example',
    'Please see attached file.',
    {
      attachments: [file.getAs(MimeType.PDF)],
      name: 'Automatic Emailer Script',
    },
);

المَعلمات

الاسم	النوع	الوصف
recipient	String	قائمة بعناوين البريد الإلكتروني مفصولة بفواصل
subject	String	موضوع الرسالة الإلكترونية (250 حرفًا كحد أقصى)
body	String	نص الرسالة الإلكترونية
options	Object	كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

المعلمات المتقدمة

الاسم	النوع	الوصف
attachments	BlobSource[]	مصفوفة من الملفات المراد إرسالها مع الرسالة الإلكترونية
bcc	String	قائمة قيم مفصولة بفاصلة لعناوين البريد الإلكتروني التي سيتم إرسال نسخة مخفية الوجهة إليها
cc	String	قائمة قيم مفصولة بفاصلة لعناوين البريد الإلكتروني التي يجب تضمينها في السطر "نسخة إلى"
from	String	عنوان البريد الإلكتروني الذي يجب إرسال الرسالة منه، ويجب أن يكون إحدى القيم التي تعرضها الدالة GmailApp.getAliases()
htmlBody	String	في حال ضبط هذا الحقل، ستستخدم الأجهزة التي يمكنها عرض HTML هذا الحقل بدلاً من وسيطة النص الأساسي المطلوبة. يمكنك إضافة حقل inlineImages اختياري في النص الأساسي لـ HTML إذا كانت لديك صور مضمّنة في رسالتك الإلكترونية.
inlineImages	Object	كائن JavaScript يحتوي على ربط من مفتاح الصورة (String) إلى بيانات الصورة (BlobSource)، وهذا يفترض أنّه يتم استخدام المَعلمة htmlBody وأنّها تحتوي على مراجع إلى هذه الصور بالتنسيق <img src="cid:imageKey" />
name	String	اسم مرسل الرسالة الإلكترونية (القيمة التلقائية: اسم المستخدم)
replyTo	String	عنوان بريد إلكتروني لاستخدامه كعنوان الردّ التلقائي (القيمة التلقائية: عنوان البريد الإلكتروني للمستخدم)

الإرجاع

GmailDraft: المسودّة المعدَّلة حديثًا

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة REST API ذات الصلة:

• https://mail.google.com/

انظر أيضًا

• GmailApp.createDraft(recipient, subject, body, options)