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.

const 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() {
  const googleLogoUrl =
      'https://www.gstatic.com/images/branding/googlelogo/1x/googlelogo_color_74x24dp.png';
  const youtubeLogoUrl =
      'https://developers.google.com/youtube/images/YouTube_logo_standard_white.png';
  const googleLogoBlob =
      UrlFetchApp.fetch(googleLogoUrl).getBlob().setName('googleLogoBlob');
  const youtubeLogoBlob =
      UrlFetchApp.fetch(youtubeLogoUrl).getBlob().setName('youtubeLogoBlob');
  MailApp.sendEmail({
    to: '[e-mail]',
    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[]	مصفوفة من الملفات المراد إرسالها مع الرسالة الإلكترونية
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, options)

---

sendEmail(recipient, subject, body)

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

MailApp.sendEmail(
    '[e-mail]',
    '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.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const blob = Utilities.newBlob(
    'Insert any HTML content here',
    'text/html',
    'my_document.html',
);
MailApp.sendEmail(
    '[e-mail]',
    '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[]	مصفوفة من الملفات المراد إرسالها مع الرسالة الإلكترونية (راجِع المثال)
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(message)

---

sendEmail(to, replyTo, subject, body)

يرسِل رسالة إلكترونية. تتيح هذه الطريقة للمستخدم تحديد عنوان Reply-To بسهولة للرسالة المرسَلة، ويمكن أن يختلف هذا العنوان عن عنوان المرسِل.

MailApp.sendEmail(
    '[e-mail]',
    '[e-mail]',
    '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