يرسل رسالة إلكترونية.
تسمح هذه الخدمة للمستخدمين بإرسال رسائل البريد الإلكتروني مع التحكم الكامل في محتوى البريد الإلكتروني. على عكس 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 } }); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
message | Object | كائن JavaScript يمثّل رسالة إلكترونية |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
attachments | BlobSource[] | CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني |
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?");
المعلمات
الاسم | النوع | الوصف |
---|---|---|
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] });
المعلمات
الاسم | النوع | الوصف |
---|---|---|
recipient | String | عناوين المستلمين مفصولة بفواصل |
subject | String | سطر الموضوع |
body | String | نص الرسالة الإلكترونية |
options | Object | كائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه |
المعلمات المتقدمة
الاسم | النوع | الوصف |
---|---|---|
attachments | BlobSource[] | CANNOT TRANSLATE مصفوفة الملفات المراد إرسالها مع البريد الإلكتروني (انظر المثال) |
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?");
المعلمات
الاسم | النوع | الوصف |
---|---|---|
to | String | عناوين المستلمين مفصولة بفواصل |
replyTo | String | عنوان الردّ |
subject | String | سطر الموضوع |
body | String | نص الرسالة الإلكترونية بنص عادي |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/script.send_mail