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: "[email protected]",
    subject: "Logos",
    htmlBody: "inline Google Logo<img src='cid:googleLogo'> images! <br>" +
              "inline YouTube Logo <img src='cid:youtubeLogo'>",
    inlineImages:
      {
        googleLogo: googleLogoBlob,
        youtubeLogo: youtubeLogoBlob
      }
  });
}

المعلمات

الاسمالنوعالوصف
messageObjectكائن JavaScript يمثّل رسالة إلكترونية

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

الاسمالنوعالوصف
attachmentsBlobSource[]CANNOT TRANSLATE مصفوفة الملفات لإرسالها باستخدام البريد الإلكتروني
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("[email protected]",
                  "TPS reports",
                  "Where are the TPS reports?");

المعلمات

الاسمالنوعالوصف
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('[email protected]', 'Attachment example', 'Two files are attached.', {
    name: 'Automatic Emailer Script',
    attachments: [file.getAs(MimeType.PDF), blob]
});

المعلمات

الاسمالنوعالوصف
recipientStringعناوين المستلمين مفصولة بفواصل
subjectStringسطر الموضوع
bodyStringنص الرسالة الإلكترونية
optionsObjectكائن JavaScript يحدّد المَعلمات المتقدّمة، كما هو موضّح أدناه

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

الاسمالنوعالوصف
attachmentsBlobSource[]CANNOT TRANSLATE مصفوفة الملفات المراد إرسالها مع البريد الإلكتروني (انظر المثال)
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("[email protected]",
                  "[email protected]",
                  "TPS report status",
                  "What is the status of those TPS reports?");

المعلمات

الاسمالنوعالوصف
toStringعناوين المستلمين مفصولة بفواصل
replyToStringعنوان الردّ
subjectStringسطر الموضوع
bodyStringنص الرسالة الإلكترونية بنص عادي

التفويض

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

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