Отправляет электронную почту.
Эта услуга позволяет пользователям отправлять электронные письма с полным контролем над содержимым электронной почты. В отличие от 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