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

المَعلمات

الاسمTypeالوصف
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'
});

المَعلمات

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

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

الاسمTypeالوصف
attachmentsBlobSource[]مصفوفة من الملفات لإرسالها مع البريد الإلكتروني
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/

يمكن أيضًا مراجعة