Эта страница переведена с помощью Cloud Translation API.

Class MailApp

Отправляет электронную почту.

Эта услуга позволяет пользователям отправлять электронные письма с полным контролем над их содержимым. В отличие от GmailApp, единственной целью MailApp является отправка электронной почты. MailApp не может получить доступ к почтовому ящику Gmail пользователя.

Изменения в скриптах, написанных с использованием GmailApp, с большей вероятностью вызовут запрос на повторную авторизацию от пользователя, чем в скриптах MailApp.

Методы

Метод	Тип возврата	Краткое описание
`get Remaining Daily Quota()`	`Integer`	Возвращает количество получателей, которым вы можете отправлять электронные письма до конца дня.
`send Email(message)`	`void`	Отправляет сообщение электронной почты.
`send Email(recipient, subject, body)`	`void`	Отправляет сообщение электронной почты.
`send Email(recipient, subject, body, options)`	`void`	Отправляет сообщение электронной почты с необязательными аргументами.
`send Email(to, replyTo, subject, body)`	`void`	Отправляет сообщение электронной почты.

Подробная документация

`get Remaining Daily Quota()`

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

Квоты основаны на количестве получателей электронной почты. Конкретную информацию о квотах см. в разделе Квоты для сервисов Google .

const emailQuotaRemaining = MailApp.getRemainingDailyQuota();
Logger.log(`Remaining email quota: ${emailQuotaRemaining}`);

Возвращаться

Integer — количество оставшихся писем, которые может отправить скрипт.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/script.send_mail

`send Email(message)`

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

// 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`	`Blob Source[]`	массив файлов для отправки по электронной почте
`bcc`	`String`	список адресов электронной почты, разделенных запятыми, для BCC
`body`	`String`	тело электронного письма
`cc`	`String`	список адресов электронной почты, разделенных запятыми, для CC
`html Body`	`String`	если установлено, устройства, способные отображать HTML, будут использовать его вместо обязательного аргумента тела; вы можете добавить дополнительное `inline Images` в тело HTML, если у вас есть встроенные изображения для вашего электронного письма.
`inline Images`	`Object`	объект JavaScript, содержащий сопоставление ключа изображения ( `String` ) с данными изображения ( `Blob Source` ); при этом предполагается, что используется параметр `html Body` и содержит ссылки на эти изображения в формате `<img src="cid:imageKey" />` (см. пример)
`name`	`String`	имя отправителя электронного письма. По умолчанию используется имя пользователя отправителя.
`no Reply`	`Boolean`	`true` , если электронное письмо должно быть отправлено с общего адреса электронной почты, на который нет ответа, чтобы получатели не отвечали на электронные письма; этот вариант возможен только для учетных записей Google Workspace, но не для пользователей Gmail.
`reply To`	`String`	адрес электронной почты, который будет использоваться в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя). Если для `no Reply` установлено значение `true` , `reply To` игнорируется.
`subject`	`String`	тема электронного письма
`to`	`String`	адрес электронной почты получателя или список адресов электронной почты, разделенных запятыми, которые будут получателями

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/script.send_mail

См. также

send Email(recipient, subject, body, options)

`send Email(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

`send Email(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`	`Blob Source[]`	массив файлов для отправки по электронной почте (см. пример)
`bcc`	`String`	список адресов электронной почты, разделенный запятыми, для BCC
`cc`	`String`	список адресов электронной почты, разделенных запятыми, для CC
`html Body`	`String`	если установлено, устройства, способные отображать HTML, будут использовать его вместо обязательного аргумента тела; вы можете добавить дополнительное `inline Images` в тело HTML, если у вас есть встроенные изображения для вашего электронного письма.
`inline Images`	`Object`	объект JavaScript, содержащий сопоставление ключа изображения ( `String` ) с данными изображения ( `Blob Source` ); при этом предполагается, что используется параметр `html Body` и содержит ссылки на эти изображения в формате `<img src="cid:imageKey" />`
`name`	`String`	имя отправителя электронного письма (по умолчанию: имя пользователя)
`no Reply`	`Boolean`	`true` , если электронное письмо должно быть отправлено с общего адреса электронной почты, на который нет ответа, чтобы получатели не отвечали на электронные письма; этот вариант возможен только для учетных записей Google Workspace, но не для пользователей Gmail.
`reply To`	`String`	адрес электронной почты, который будет использоваться в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/script.send_mail

См. также

send Email(message)

`send Email(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`	адреса получателей через запятую
`reply To`	`String`	ответный адрес
`subject`	`String`	тема письма
`body`	`String`	тело письма в виде обычного текста

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

https://www.googleapis.com/auth/script.send_mail