مسودة رسالة أنشأها المستخدم في حساب مستخدم على 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());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
recipient | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل |
subject | String | موضوع رسالة البريد الإلكتروني (250 حرفًا بحد أقصى) |
body | String | نص الرسالة الإلكترونية |
الإرجاع
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' });
المعلمات
الاسم | النوع | الوصف |
---|---|---|
recipient | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل |
subject | String | موضوع رسالة البريد الإلكتروني (250 حرفًا بحد أقصى) |
body | String | نص الرسالة الإلكترونية |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
attachments | BlobSource[] | CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني |
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 ذات الصلة:
-
https://mail.google.com/