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 Отправляет электронное письмо.

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

getRemainingDailyQuota()

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

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

const 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() {
  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 Список адресов электронной почты, разделенных запятыми, для указания в копии.
html Body String Если этот параметр задан, устройства, способные отображать HTML, будут использовать его вместо обязательного аргумента body; вы можете добавить необязательное поле 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

См. также

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.
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 Список адресов электронной почты, разделенных запятыми, для указания в копии.
html Body String Если этот параметр задан, устройства, способные отображать HTML, будут использовать его вместо обязательного аргумента body; вы можете добавить необязательное поле 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

См. также

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 Адреса получателей, разделенные запятыми.
reply To String адрес для ответа
subject String тема письма
body String Текст электронного письма в открытом виде

Авторизация

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

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