Отправляет электронную почту.
Эта услуга позволяет пользователям отправлять электронные письма с полным контролем над их содержимым. В отличие от 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: "[email protected]", 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("[email protected]", "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('[email protected]', '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("[email protected]", "[email protected]", "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