Эта страница переведена с помощью 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[]`	массив файлов для отправки по электронной почте
`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, 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[]`	массив файлов для отправки по электронной почте (см. пример)
`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(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