تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class 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)`

إرسال رسالة إلكترونية يُعدّ هذا الصيغة من الطريقة أكثر مرونة، ما يتيح العديد من options. المزيد من الخيارات.

// 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: '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[]`	ملف متعدّد لإرساله مع الرسالة الإلكترونية
`bcc`	`String`	قائمة مفصولة بفواصل بعناوين البريد الإلكتروني المراد إرسال نسخة مخفية منها إلى البريد الإلكتروني
`body`	`String`	نص الرسالة الإلكترونية
`cc`	`String`	قائمة مفصولة بفواصل بعناوين البريد الإلكتروني التي يجب تضمينها في السطر "نسخة إلى"
`htmlBody`	`String`	في حال ضبطها، ستستخدم الأجهزة القادرة على عرض HTML هذا الحقل بدلاً من الوسيطة المطلوبة body. يمكنك إضافة حقل `inlineImages` اختياري في HTML body إذا كانت لديك صور مضمّنة لبريدك الإلكتروني.
`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(
    '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.
const file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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[]`	ملف يحتوي على مجموعة من الملفات المطلوب إرسالها مع الرسالة الإلكترونية (راجِع المثال)
`bcc`	`String`	قائمة مفصولة بفواصل بعناوين البريد الإلكتروني المراد إرسال نسخة مخفية منها إلى البريد الإلكتروني
`cc`	`String`	قائمة مفصولة بفواصل بعناوين البريد الإلكتروني التي يجب تضمينها في السطر "نسخة إلى"
`htmlBody`	`String`	في حال ضبطها، ستستخدم الأجهزة القادرة على عرض HTML هذا الحقل بدلاً من الوسيطة المطلوبة body. يمكنك إضافة حقل `inlineImages` اختياري في HTML body إذا كانت لديك صور مضمّنة لبريدك الإلكتروني.
`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(
    '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