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[] массив файлов для отправки по электронной почте
bcc String разделенный запятыми список адресов электронной почты для BCC
body String тело письма
cc String разделенный запятыми список адресов электронной почты для CC
htmlBody String если установлено, устройства, способные отображать HTML, будут использовать его вместо обязательного аргумента body; вы можете добавить необязательное поле 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)

Отправляет сообщение электронной почты.

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[] массив файлов для отправки по электронной почте (см. пример)
bcc String разделенный запятыми список адресов электронной почты для BCC
cc String разделенный запятыми список адресов электронной почты для CC
htmlBody String если установлено, устройства, способные отображать HTML, будут использовать его вместо обязательного аргумента body; вы можете добавить необязательное поле 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(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