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()

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

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

التفويض

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

  • https://mail.google.com/

getId()

الحصول على رقم تعريف مسودة الرسالة هذه

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

الإرجاع

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

التفويض

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

  • https://mail.google.com/

getMessage()

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

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

الإرجاع

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

التفويض

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

  • https://mail.google.com/

getMessageId()

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

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

الإرجاع

String - رقم تعريف الرسالة

التفويض

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

  • https://mail.google.com/

send()

لإرسال مسودة الرسالة الإلكترونية هذه. يكون حجم الرسالة الإلكترونية (بما في ذلك الرؤوس) محدودًا.

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

الإرجاع

GmailMessage - الرسالة المُرسَلة مؤخرًا

التفويض

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

  • https://mail.google.com/

update(recipient, subject, body)

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

// The code below will update a draft email with the current date and time.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder
var now = new Date();
draft.update("mike@example.com", "current time", "The time is: " + now.toString());

المعلمات

الاسمالنوعالوصف
recipientStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل
subjectStringموضوع رسالة البريد الإلكتروني (250 حرفًا بحد أقصى)
bodyStringنص الرسالة الإلكترونية

الإرجاع

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

التفويض

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

  • https://mail.google.com/

انظر أيضًا


update(recipient, subject, body, options)

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

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

المعلمات

الاسمالنوعالوصف
recipientStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل
subjectStringموضوع رسالة البريد الإلكتروني (250 حرفًا بحد أقصى)
bodyStringنص الرسالة الإلكترونية
optionsObjectكائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
attachmentsBlobSource[]CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
bccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل من أجل "نسخة مخفية الوجهة"
ccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إلى
fromStringهو العنوان الذي يجب إرسال الرسالة منه، والذي يجب أن يكون واحدًا من القيم التي تعرضها الدالة GmailApp.getAliases()
htmlBodyStringإذا تم ضبطها، ستستخدمها الأجهزة القادرة على عرض ترميز HTML بدلاً من ذلك وسيطة النص الأساسي المطلوبة يمكنك إضافة حقل inlineImages اختياري في HTML إذا كانت لديك صور مضمّنة لبريدك الإلكتروني
inlineImagesObjectكائن JavaScript يحتوي على ربط من مفتاح صورة (String) إلى بيانات الصورة (BlobSource) يفترض ذلك أن المعلمة htmlBody مستخدمة وتحتوي على إشارات إلى هذه الصور بالتنسيق <img src="cid:imageKey" />
nameStringاسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم)
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم)

الإرجاع

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

التفويض

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

  • https://mail.google.com/

انظر أيضًا