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, будут использовать его вместо обязательного аргумента тела; вы можете добавить дополнительное поле 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, будут использовать его вместо обязательного аргумента тела; вы можете добавить дополнительное поле 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)

Отправляет сообщение электронной почты. Этот метод позволяет пользователю легко указать адрес ответа для отправленного сообщения, который может отличаться от адреса отправителя. 

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