Class MailApp

MailApp

إرسال رسالة إلكترونية

تتيح هذه الخدمة للمستخدمين إرسال رسائل إلكترونية مع التحكّم الكامل في محتوى الرسائل الإلكترونية. على عكس 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الوصف
messageObjectكائن JavaScript يمثل رسالة إلكترونية

المعلمات المتقدمة

الاسمTypeالوصف
attachmentsBlobSource[]مصفوفة من الملفات لإرسالها مع البريد الإلكتروني
bccStringقائمة مفصولة بفواصل من عناوين البريد الإلكتروني إلى "نسخة مخفية الوجهة"
bodyStringنص الرسالة الإلكترونية
ccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إليها
htmlBodyStringوإذا تم ضبط السياسة، ستستخدمها الأجهزة التي يمكنها عرض ترميز HTML بدلاً من وسيطة النص المطلوبة. ويمكنك إضافة حقل inlineImages اختياري في نص HTML إذا كانت لديك صور مضمّنة لبريدك الإلكتروني.
inlineImagesObjectكائن JavaScript يحتوي على تعيين من مفتاح الصورة (String) إلى بيانات الصورة (BlobSource)، وهذا يفترض أنّه تم استخدام المَعلمة htmlBody ويحتوي على مراجع لهذه الصور بالتنسيق <img src="cid:imageKey" /> (راجِع مثال)
nameStringاسم مُرسِل البريد الإلكتروني. يتم ضبط هذه الخاصية تلقائيًا على اسم المستخدم للمُرسِل.
noReplyBooleantrue إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني لا يمكن تلقّي الردود عليه من أجل منع المستلِمين من الردّ على الرسائل الإلكترونية، هذا الخيار متاح فقط لحسابات Google Workspace وليس لمستخدمي Gmail.
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (التلقائي: عنوان البريد الإلكتروني للمستخدم). وفي حال ضبط noReply على true، سيتم تجاهل replyTo.
subjectStringموضوع رسالة البريد الإلكتروني
toStringعنوان البريد الإلكتروني للمستلم أو قائمة مفصولة بفواصل من عناوين البريد الإلكتروني لتكون المستلمين

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • 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الوصف
recipientStringعناوين المستلمين، مفصولة بفواصل
subjectStringسطر الموضوع
bodyStringنص الرسالة الإلكترونية

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • 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الوصف
recipientStringعناوين المستلمين، مفصولة بفواصل
subjectStringسطر الموضوع
bodyStringنص الرسالة الإلكترونية
optionsObjectكائن JavaScript يحدّد المعلمات المتقدمة، كما هو موضّح أدناه

المعلمات المتقدمة

الاسمTypeالوصف
attachmentsBlobSource[]مصفوفة من الملفات لإرسالها باستخدام الرسالة الإلكترونية (اطّلِع على مثال)
bccStringقائمة مفصولة بفواصل من عناوين البريد الإلكتروني إلى "نسخة مخفية الوجهة"
ccStringقائمة بعناوين البريد الإلكتروني مفصولة بفواصل لإرسال نسخة إليها
htmlBodyStringوإذا تم ضبط السياسة، ستستخدمها الأجهزة التي يمكنها عرض ترميز HTML بدلاً من وسيطة النص المطلوبة. ويمكنك إضافة حقل inlineImages اختياري في نص HTML إذا كانت لديك صور مضمّنة لبريدك الإلكتروني.
inlineImagesObjectكائن JavaScript يحتوي على تعيين من مفتاح الصورة (String) إلى بيانات الصورة (BlobSource)، وهذا يفترض أنّه تم استخدام المَعلمة htmlBody ويحتوي على مراجع لهذه الصور بالتنسيق <img src="cid:imageKey" />.
nameStringاسم مُرسِل الرسالة الإلكترونية (التلقائي: اسم المستخدم)
noReplyBooleantrue إذا كان يجب إرسال الرسالة الإلكترونية من عنوان بريد إلكتروني لا يمكن تلقّي الردود عليه من أجل منع المستلِمين من الردّ على الرسائل الإلكترونية، هذا الخيار متاح فقط لحسابات Google Workspace وليس لمستخدمي Gmail.
replyToStringعنوان بريد إلكتروني لاستخدامه كعنوان الرد التلقائي (التلقائي: عنوان البريد الإلكتروني للمستخدم)

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • 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الوصف
toStringعناوين المستلمين، مفصولة بفواصل
replyToStringعنوان الرد
subjectStringسطر الموضوع
bodyStringنص الرسالة الإلكترونية بنص عادي

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/script.send_mail