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