رسالة مسودة أنشأها المستخدم في حساب Gmail للمستخدم.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
deleteDraft() | void | سيتم حذف مسودة الرسالة هذه. |
getId() | String | يحصل على رقم تعريف رسالة المسودة هذه. |
getMessage() | GmailMessage | تعرض رسالة Gmail تمثل هذه المسودة. |
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()
تعرض رسالة Gmail تمثل هذه المسودة.
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[] | مصفوفة من الملفات لإرسالها عبر الرسالة الإلكترونية |
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 | اسم مُرسِل الرسالة الإلكترونية (الإعداد التلقائي: اسم المستخدم's) |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (تلقائي: عنوان البريد الإلكتروني للمستخدم's) |
تذكرة ذهاب وعودة
GmailDraft
— المسودة التي تم تحديثها مؤخرًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://mail.google.com/