تمت ترجمة هذه الصفحة بواسطة 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. الخدمات:

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, 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.
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(message)

`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