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