إرسال رسالة إلكترونية
تتيح هذه الخدمة للمستخدمين إرسال رسائل إلكترونية مع التحكّم الكامل في محتوى الرسائل الإلكترونية. على عكس GmailApp، الغرض الوحيد لتطبيق MailApp هو إرسال الرسائل الإلكترونية. لا يمكن لتطبيق MailApp الوصول إلى البريد الوارد في Gmail للمستخدم.
من المرجّح أن تؤدي التغييرات في النصوص البرمجية المكتوبة باستخدام GmailApp إلى تشغيل طلب إعادة التفويض من المستخدم بدلاً من النصوص البرمجية لـ MailApp.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
getRemainingDailyQuota() | Integer | يعرض عدد المستلمين الذين يمكنك إرسال رسائل إلكترونية إليهم لبقية اليوم. |
sendEmail(message) | void | إرسال رسالة إلكترونية |
sendEmail(recipient, subject, body) | void | إرسال رسالة إلكترونية |
sendEmail(recipient, subject, body, options) | void | يرسل رسالة إلكترونية تحتوي على وسيطات اختيارية. |
sendEmail(to, replyTo, subject, body) | void | إرسال رسالة إلكترونية |
الوثائق التفصيلية
getRemainingDailyQuota()
يعرض عدد المستلمين الذين يمكنك إرسال رسائل إلكترونية إليهم لبقية اليوم. وتكون القيمة المعروضة صالحة للتنفيذ الحالي وقد تختلف بين عمليات التنفيذ.
تستند الحصص إلى عدد مُستلِمي الرسالة الإلكترونية. للحصول على معلومات عن الحصص المحدّدة، يُرجى الاطّلاع على حصص خدمات Google.
var emailQuotaRemaining = MailApp.getRemainingDailyQuota(); Logger.log("Remaining email quota: " + emailQuotaRemaining);
استرجاع الكرة
Integer
— عدد الرسائل الإلكترونية المتبقية التي يمكن للنص البرمجي إرسالها
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(message)
إرسال رسالة إلكترونية هذا الاختلاف في الطريقة أكثر مرونة، مما يسمح بالعديد من الخيارات.
// This code fetches the Google and YouTube logos, inlines them in an email // and sends the email function inlineImage() { var googleLogoUrl = "https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png"; var youtubeLogoUrl = "https://developers.google.com/youtube/images/YouTube_logo_standard_white.png"; var googleLogoBlob = UrlFetchApp .fetch(googleLogoUrl) .getBlob() .setName("googleLogoBlob"); var youtubeLogoBlob = UrlFetchApp .fetch(youtubeLogoUrl) .getBlob() .setName("youtubeLogoBlob"); MailApp.sendEmail({ to: "recipient@example.com", subject: "Logos", htmlBody: "inline Google Logo<img src='cid:googleLogo'> images! <br>" + "inline YouTube Logo <img src='cid:youtubeLogo'>", inlineImages: { googleLogo: googleLogoBlob, youtubeLogo: youtubeLogoBlob } }); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
message | Object | كائن JavaScript يمثل رسالة إلكترونية |
المعلمات المتقدمة
الاسم | Type | الوصف |
---|---|---|
attachments | BlobSource[] | مصفوفة من الملفات لإرسالها مع البريد الإلكتروني |
bcc | String | قائمة مفصولة بفواصل من عناوين البريد الإلكتروني إلى "نسخة مخفية الوجهة" |
body | String | نص الرسالة الإلكترونية |
cc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إليها |
htmlBody | String | وإذا تم ضبط السياسة، ستستخدمها الأجهزة التي يمكنها عرض ترميز HTML
بدلاً من وسيطة النص المطلوبة. ويمكنك إضافة حقل inlineImages اختياري في نص
HTML إذا كانت لديك صور مضمّنة لبريدك الإلكتروني. |
inlineImages | Object | كائن JavaScript يحتوي على تعيين من مفتاح الصورة (String ) إلى بيانات الصورة (BlobSource )، وهذا يفترض أنّه تم استخدام المَعلمة htmlBody ويحتوي على مراجع لهذه الصور بالتنسيق <img src="cid:imageKey" /> (راجِع مثال) |
name | String | اسم مُرسِل البريد الإلكتروني. يتم ضبط هذه الخاصية تلقائيًا على اسم المستخدم للمُرسِل. |
noReply | Boolean | true إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني
لا يمكن تلقّي الردود عليه من أجل منع المستلِمين من الردّ على الرسائل الإلكترونية، هذا الخيار متاح فقط لحسابات Google Workspace وليس لمستخدمي Gmail. |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي
(التلقائي: عنوان البريد الإلكتروني للمستخدم). وفي حال ضبط noReply على true ، سيتم تجاهل replyTo . |
subject | String | موضوع رسالة البريد الإلكتروني |
to | String | عنوان البريد الإلكتروني للمستلم أو قائمة مفصولة بفواصل من عناوين البريد الإلكتروني لتكون المستلمين |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/script.send_mail
يمكن أيضًا مراجعة
sendEmail(recipient, subject, body)
إرسال رسالة إلكترونية
MailApp.sendEmail("recipient@example.com", "TPS reports", "Where are the TPS reports?");
المَعلمات
الاسم | Type | الوصف |
---|---|---|
recipient | String | عناوين المستلمين، مفصولة بفواصل |
subject | String | سطر الموضوع |
body | String | نص الرسالة الإلكترونية |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/script.send_mail
sendEmail(recipient, subject, body, options)
يرسل رسالة إلكترونية تحتوي على وسيطات اختيارية.
// Send an email with two attachments: a file from Google Drive (as a PDF) and an HTML file. var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); var blob = Utilities.newBlob('Insert any HTML content here', 'text/html', 'my_document.html'); MailApp.sendEmail('mike@example.com', 'Attachment example', 'Two files are attached.', { name: 'Automatic Emailer Script', attachments: [file.getAs(MimeType.PDF), blob] });
المَعلمات
الاسم | Type | الوصف |
---|---|---|
recipient | String | عناوين المستلمين، مفصولة بفواصل |
subject | String | سطر الموضوع |
body | String | نص الرسالة الإلكترونية |
options | Object | كائن JavaScript يحدّد المعلمات المتقدمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | Type | الوصف |
---|---|---|
attachments | BlobSource[] | مصفوفة من الملفات لإرسالها باستخدام الرسالة الإلكترونية (اطّلِع على مثال) |
bcc | String | قائمة مفصولة بفواصل من عناوين البريد الإلكتروني إلى "نسخة مخفية الوجهة" |
cc | String | قائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إليها |
htmlBody | String | وإذا تم ضبط السياسة، ستستخدمها الأجهزة التي يمكنها عرض ترميز HTML
بدلاً من وسيطة النص المطلوبة. ويمكنك إضافة حقل inlineImages اختياري في نص
HTML إذا كانت لديك صور مضمّنة لبريدك الإلكتروني. |
inlineImages | Object | كائن JavaScript يحتوي على تعيين من مفتاح الصورة (String ) إلى بيانات الصورة (BlobSource )، وهذا يفترض أنّه تم استخدام المَعلمة htmlBody ويحتوي على مراجع لهذه الصور بالتنسيق <img src="cid:imageKey" /> . |
name | String | اسم مُرسِل الرسالة الإلكترونية (التلقائي: اسم المستخدم) |
noReply | Boolean | true إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني
لا يمكن تلقّي الردود عليه من أجل منع المستلِمين من الردّ على الرسائل الإلكترونية، هذا الخيار متاح فقط لحسابات Google Workspace وليس لمستخدمي Gmail. |
replyTo | String | عنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (التلقائي: عنوان البريد الإلكتروني للمستخدم) |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/script.send_mail
يمكن أيضًا مراجعة
sendEmail(to, replyTo, subject, body)
إرسال رسالة إلكترونية تتيح هذه الطريقة للمستخدم أن يحدد بسهولة عنوان "الرد على" للرسالة المرسلة التي يمكن أن تختلف عن المرسل.
MailApp.sendEmail("recipient@example.com", "replies@example.com", "TPS report status", "What is the status of those TPS reports?");
المَعلمات
الاسم | Type | الوصف |
---|---|---|
to | String | عناوين المستلمين، مفصولة بفواصل |
replyTo | String | عنوان الرد |
subject | String | سطر الموضوع |
body | String | نص الرسالة الإلكترونية بنص عادي |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/script.send_mail