Class GmailMessage

GmailСообщение

Сообщение в учетной записи Gmail пользователя.

Методы

Метод Тип возврата Краткое описание
createDraftReply(body) GmailDraft Создает черновик сообщения, отвечая отправителю этого сообщения, используя адрес для ответа.
createDraftReply(body, options) GmailDraft Создает черновик сообщения, отвечающего отправителю этого сообщения, используя адрес для ответа и необязательные аргументы.
createDraftReplyAll(body) GmailDraft Создает черновик сообщения, отвечающего отправителю, используя адрес для ответа и всех получателей этого сообщения.
createDraftReplyAll(body, options) GmailDraft Создает черновик сообщения, отвечающего отправителю этого сообщения, используя адрес для ответа и всех получателей, с необязательными аргументами.
forward(recipient) GmailMessage Пересылает это сообщение новым получателям.
forward(recipient, options) GmailMessage Пересылает это сообщение новым получателям с необязательными аргументами.
getAttachments() GmailAttachment[] Получает все вложения к этому сообщению.
getAttachments(options) GmailAttachment[] Получает все вложения к этому сообщению.
getBcc() String Получает скрытую копию получателей, разделенных запятыми, в этом сообщении.
getBody() String Получает HTML-содержимое тела этого сообщения.
getCc() String Получает разделенных запятыми получателей копии этого сообщения.
getDate() Date Получает дату и время этого сообщения.
getFrom() String Получает отправителя этого сообщения.
getHeader(name) String Получает значение заголовка RFC 2822 по имени заголовка.
getId() String Получает идентификатор этого сообщения.
getPlainBody() String Получает содержимое тела этого сообщения без форматирования HTML.
getRawContent() String Получает необработанное содержимое этого сообщения.
getReplyTo() String Получает адрес для ответа на это сообщение (обычно отправителя).
getSubject() String Получает тему этого сообщения.
getThread() GmailThread Получает поток, содержащий это сообщение.
getTo() String Получает разделенных запятыми получателей этого сообщения.
isDraft() Boolean Проверяет, является ли это сообщение черновиком.
isInChats() Boolean Проверяет, является ли это сообщение чатом.
isInInbox() Boolean Проверяет, находится ли это сообщение во входящих.
isInPriorityInbox() Boolean Возвращает true , если это сообщение находится в приоритетном почтовом ящике; в противном случае возвращает false .
isInTrash() Boolean Проверяет, находится ли это сообщение в корзине.
isStarred() Boolean Проверяет, помечено ли это сообщение.
isUnread() Boolean Проверяет, является ли это сообщение непрочитанным.
markRead() GmailMessage Отмечает сообщение как прочитанное.
markUnread() GmailMessage Помечает сообщение как непрочитанное.
moveToTrash() GmailMessage Перемещает сообщение в корзину.
refresh() GmailMessage Перезагружает это сообщение и связанное с ним состояние из Gmail (полезно, если изменились метки, состояние чтения и т. д.).
reply(body) GmailMessage Ответ отправителю этого сообщения с использованием адреса для ответа.
reply(body, options) GmailMessage Отвечает отправителю этого сообщения с использованием адреса для ответа и необязательных аргументов.
replyAll(body) GmailMessage Ответ отправителю с использованием адреса ответа и всех получателей этого сообщения.
replyAll(body, options) GmailMessage Отвечает отправителю этого сообщения, используя адрес для ответа и всех получателей, с необязательными аргументами.
star() GmailMessage Помечает сообщение.
unstar() GmailMessage Снимает пометку с сообщения.

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

createDraftReply(body)

Создает черновик сообщения, отвечая отправителю этого сообщения, используя адрес для ответа. Размер электронного письма (включая заголовки) ограничен квотой .

// Create a draft reply to the original message with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("Got your message");

Параметры

Имя Тип Описание
body String Тело письма.

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

GmailDraft — новый черновик сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

createDraftReply(body, options)

Создает черновик сообщения, отвечающего отправителю этого сообщения, используя адрес для ответа и необязательные аргументы.

Электронное письмо может содержать как обычный текст, так и тело HTML. Размер электронного письма (включая заголовки) ограничен квотой .

// Create a draft response with an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Параметры

Имя Тип Описание
body String Тело письма.
options Object Объект JavaScript, задающий дополнительные параметры, как указано ниже.

Расширенные параметры

Имя Тип Описание
attachments BlobSource[] массив файлов для отправки по электронной почте
bcc String список адресов электронной почты, разделенных запятыми, для BCC
cc String список адресов электронной почты, разделенных запятыми, для CC
from String адрес, с которого должно быть отправлено электронное письмо, который должен быть одним из значений, возвращаемых GmailApp.getAliases()
htmlBody String если этот параметр установлен, устройства, способные отображать HTML, используют его вместо обязательного аргумента тела; вы можете добавить дополнительное поле inlineImages в тело HTML, если у вас есть встроенные изображения для вашей электронной почты.
inlineImages Object объект JavaScript, содержащий сопоставление ключа изображения ( String ) с данными изображения ( BlobSource ); при этом предполагается, что используется параметр htmlBody и содержит ссылки на эти изображения в формате <img src="cid:imageKey" />
name String имя отправителя электронного письма (по умолчанию: имя пользователя)
replyTo String адрес электронной почты, который будет использоваться в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)
subject String Новая тема письма длиной до 250 символов.

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

GmailDraft — новый черновик сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

createDraftReplyAll(body)

Создает черновик сообщения, отвечающего отправителю, используя адрес для ответа и всех получателей этого сообщения. Размер электронного письма (включая заголовки) ограничен квотой .

// Create a draft response to all recipients (except those bcc'd) with an acknowledgment.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

Параметры

Имя Тип Описание
body String Тело письма.

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

GmailDraft — новый черновик сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

createDraftReplyAll(body, options)

Создает черновик сообщения, отвечающего отправителю этого сообщения, используя адрес для ответа и всех получателей, с необязательными аргументами.

Электронное письмо может содержать как обычный текст, так и тело HTML. Размер электронного письма (включая заголовки) ограничен квотой .

// Create a draft response to all recipients (except those bcc'd) using an HTML text body.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Параметры

Имя Тип Описание
body String Тело письма.
options Object Объект JavaScript, задающий дополнительные параметры, как указано ниже.

Расширенные параметры

Имя Тип Описание
attachments BlobSource[] массив файлов для отправки по электронной почте
bcc String список адресов электронной почты, разделенных запятыми, для BCC
cc String список адресов электронной почты, разделенных запятыми, для CC
from String адрес, с которого должно быть отправлено электронное письмо, который должен быть одним из значений, возвращаемых GmailApp.getAliases()
htmlBody String если этот параметр установлен, устройства, способные отображать HTML, используют его вместо обязательного аргумента тела; вы можете добавить дополнительное поле inlineImages в тело HTML, если у вас есть встроенные изображения для вашей электронной почты.
inlineImages Object объект JavaScript, содержащий сопоставление ключа изображения ( String ) с данными изображения ( BlobSource ); при этом предполагается, что используется параметр htmlBody и содержит ссылки на эти изображения в формате <img src="cid:imageKey" />
name String имя отправителя электронного письма (по умолчанию: имя пользователя)
replyTo String адрес электронной почты, который будет использоваться в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)
subject String Новая тема письма длиной до 250 символов.

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

GmailDraft — новый черновик сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

forward(recipient)

Пересылает это сообщение новым получателям. Размер электронного письма (включая заголовки) ограничен квотой .

// Forward first message of first inbox thread to recipient1 & recipient2, both @example.com
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com");

Параметры

Имя Тип Описание
recipient String Список адресов электронной почты, разделенный запятыми.

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

GmailMessage — это сообщение полезно для цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

forward(recipient, options)

Пересылает это сообщение новым получателям с необязательными аргументами.

Электронное письмо может содержать как обычный текст, так и тело HTML. Размер электронного письма (включая заголовки) ограничен квотой .

var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.forward("recipient1@example.com,recipient2@example.com", {
  cc: "myboss@example.com",
  bcc: "mybosses-boss@example.com,vp@example.com"
});

Параметры

Имя Тип Описание
recipient String Список адресов электронной почты, разделенный запятыми.
options Object Объект JavaScript, задающий дополнительные параметры, как указано ниже.

Расширенные параметры

Имя Тип Описание
attachments BlobSource[] массив файлов для отправки по электронной почте
bcc String список адресов электронной почты, разделенных запятыми, для BCC
cc String список адресов электронной почты, разделенных запятыми, для CC
from String адрес, с которого должно быть отправлено электронное письмо, который должен быть одним из значений, возвращаемых GmailApp.getAliases()
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 адрес электронной почты, который будет использоваться в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)
subject String Новая тема письма длиной до 250 символов.

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

GmailMessage — это сообщение полезно для цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

getAttachments()

Получает все вложения к этому сообщению.

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

GmailAttachment[] — массив вложений Blob для этого сообщения.

Авторизация

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

  • https://mail.google.com/

getAttachments(options)

Получает все вложения к этому сообщению.

Параметры

Имя Тип Описание
options Object Объект JavaScript, задающий дополнительные параметры, как указано ниже.

Расширенные параметры

Имя Тип Описание
includeInlineImages Boolean true , если возвращаемый массив вложений Blob должен включать встроенные изображения (по умолчанию — true ).
includeAttachments Boolean true , если возвращаемый массив вложений Blob должен включать обычные (не встроенные) вложения (по умолчанию — true ).

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

GmailAttachment[] — массив вложений Blob для этого сообщения.

Авторизация

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

  • https://mail.google.com/

getBcc()

Получает скрытую копию получателей, разделенных запятыми, в этом сообщении.

По определению оно пусто для всех полученных сообщений.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBcc()); // Log bcc'd addresses

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

String — разделенные запятыми получатели скрытой копии этого сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

getBody()

Получает HTML-содержимое тела этого сообщения.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getBody()); // Log contents of the body

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

String — текст сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

getCc()

Получает разделенных запятыми получателей копии этого сообщения.

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getCc()); // Log cc'd addresses

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

String — разделенные запятыми получатели, отправившие копию этого сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

getDate()

Получает дату и время этого сообщения. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getDate()); // Log date and time of the message

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

Date — дата и время этого сообщения.

Авторизация

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

  • https://mail.google.com/

getFrom()

Получает отправителя этого сообщения. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getFrom()); // Log from address of the message

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

String — адрес электронной почты отправителя сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

getHeader(name)

Получает значение заголовка RFC 2822 по имени заголовка. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox.
var message = thread.getMessages()[0];         // Get the first message.
Logger.log(message.getHeader("Message-ID"));   // Logs the Message-ID RFC 2822 header.

Параметры

Имя Тип Описание
name String Имя заголовка RFC без двоеточия, отделяющего его от значения.

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

String — значение заголовка или пустая строка, если заголовок не существует в сообщении.

Авторизация

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

  • https://mail.google.com/

getId()

Получает идентификатор этого сообщения. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
var id = message.getId();
var messageById = GmailApp.getMessageById(id);
Logger.log(message.getSubject() == messageById.getMessage()); // Always logs true

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

String — идентификатор сообщения.

getPlainBody()

Получает содержимое тела этого сообщения без форматирования HTML. Это сложнее, чем getBody() и занимает больше времени. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getPlainBody()); // Log contents of the body

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

String — простое содержимое этого сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

getRawContent()

Получает необработанное содержимое этого сообщения. Это эквивалентно команде «Показать оригинал» в пользовательском интерфейсе Gmail.

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

String — необработанное содержимое этого сообщения.

Авторизация

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

  • https://mail.google.com/

getReplyTo()

Получает адрес для ответа на это сообщение (обычно отправителя). 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getReplyTo()); // Logs reply-to address

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

String — адрес электронной почты для ответов.

Авторизация

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

  • https://mail.google.com/

См. также

getSubject()

Получает тему этого сообщения. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getSubject()); // Log subject line

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

String — тема этого сообщения.

Авторизация

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

  • https://mail.google.com/

См. также

getThread()

Получает поток, содержащий это сообщение. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getThread().getFirstMessageSubject() ==
           thread.getFirstMessageSubject()); // Always logs true

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

GmailThread — GmailThread, содержащий это сообщение.

Авторизация

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

  • https://mail.google.com/

getTo()

Получает разделенных запятыми получателей этого сообщения. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log(message.getTo()); // Log the recipient of message

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

String — получатели этого сообщения, разделенные запятыми.

Авторизация

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

  • https://mail.google.com/

См. также

isDraft()

Проверяет, является ли это сообщение черновиком. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is draft? " + message.isDraft());

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

Boolean — является ли это сообщение черновиком.

Авторизация

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

  • https://mail.google.com/

isInChats()

Проверяет, является ли это сообщение чатом. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is a chat? " + message.isInChats());

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

Boolean — является ли это сообщение чатом.

isInInbox()

Проверяет, находится ли это сообщение во входящих. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in inbox? " + message.isInInbox());

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

Boolean — находится ли это сообщение во входящих.

Авторизация

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

  • https://mail.google.com/

isInPriorityInbox()

Возвращает true , если это сообщение находится в приоритетном почтовом ящике; в противном случае возвращает false . 

var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox
var messages = thread.getMessages();
for (var i = 0; i < messages.length; i++) {
  // At least one of the messages is in priority inbox
  Logger.log("is in priority inbox? " + messages[i].isInPriorityInbox());
}

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

Boolean — находится ли это сообщение в приоритетном почтовом ящике.

Авторизация

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

  • https://mail.google.com/

isInTrash()

Проверяет, находится ли это сообщение в корзине. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is in the trash? " + message.isInTrash());

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

Boolean — находится ли это сообщение в корзине.

isStarred()

Проверяет, помечено ли это сообщение. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is starred? " + message.isStarred());

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

Boolean — Помечено ли это сообщение.

isUnread()

Проверяет, является ли это сообщение непрочитанным. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
Logger.log("is unread? " + message.isUnread());

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

Boolean — непрочитанный статус этого сообщения.

Авторизация

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

  • https://mail.google.com/

markRead()

Отмечает сообщение как прочитанное. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markRead(); // Mark as read

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

GmailMessage — это GmailMessage, полезное для создания цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

markUnread()

Помечает сообщение как непрочитанное. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.markUnread(); // Mark as unread

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

GmailMessage — это GmailMessage, полезное для создания цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

moveToTrash()

Перемещает сообщение в корзину. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.moveToTrash(); // Move message to trash

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

GmailMessage — это GmailMessage, полезное для создания цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

refresh()

Перезагружает это сообщение и связанное с ним состояние из Gmail (полезно, если изменились метки, состояние чтения и т. д.). 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
// .. Do bunch of stuff here
message.refresh(); // Make sure it's up to date
// Do more stuff to message

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

GmailMessage — это сообщение для цепочки.

Авторизация

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

  • https://mail.google.com/

reply(body)

Ответы отправителю этого сообщения с использованием адреса для ответа. Размер электронного письма (включая заголовки) ограничен квотой . 

// Respond to author of message with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("Got your message");

Параметры

Имя Тип Описание
body String Тело письма.

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

GmailMessage — это сообщение полезно для цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

reply(body, options)

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

Электронное письмо может содержать как обычный текст, так и тело HTML. Размер электронного письма (включая заголовки) ограничен квотой . 

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.reply("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Параметры

Имя Тип Описание
body String Тело письма.
options Object Объект JavaScript, задающий дополнительные параметры, как указано ниже.

Расширенные параметры

Имя Тип Описание
attachments BlobSource[] массив файлов для отправки по электронной почте
bcc String список адресов электронной почты, разделенных запятыми, для BCC
cc String список адресов электронной почты, разделенных запятыми, для CC
from String адрес, с которого должно быть отправлено электронное письмо, который должен быть одним из значений, возвращаемых GmailApp.getAliases()
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 адрес электронной почты, который будет использоваться в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)
subject String Новая тема письма длиной до 250 символов.

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

GmailMessage — это сообщение полезно для цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

replyAll(body)

Ответ отправителю с использованием адреса ответа и всех получателей этого сообщения. Размер электронного письма (включая заголовки) ограничен квотой . 

// Respond to all recipients (except bcc'd) of last email in thread with acknowledgment
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.replyAll("Got your message");

Параметры

Имя Тип Описание
body String Тело письма.

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

GmailMessage — это сообщение, полезное для создания цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

replyAll(body, options)

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

Электронное письмо может содержать как обычный текст, так и тело HTML. Размер электронного письма (включая заголовки) ограничен квотой . 

// Respond with HTML body text
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
messageThread.replyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  noReply: true
});

Параметры

Имя Тип Описание
body String Тело письма.
options Object Объект JavaScript, задающий дополнительные параметры, как указано ниже.

Расширенные параметры

Имя Тип Описание
attachments BlobSource[] массив файлов для отправки по электронной почте
bcc String список адресов электронной почты, разделенных запятыми, для BCC
cc String список адресов электронной почты, разделенных запятыми, для CC
from String адрес, с которого должно быть отправлено электронное письмо, который должен быть одним из значений, возвращаемых GmailApp.getAliases()
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 адрес электронной почты, который будет использоваться в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)
subject String Новая тема письма длиной до 250 символов.

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

GmailMessage — это сообщение полезно для цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

star()

Помечает сообщение. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.star(); // Star the message

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

GmailMessage — это GmailMessage, полезное для создания цепочки.

Авторизация

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

  • https://mail.google.com/

См. также

unstar()

Снимает пометку с сообщения. 

var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox
var message = thread.getMessages()[0]; // Get first message
message.unstar(); // Unstar the message

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

GmailMessage — это GmailMessage, полезное для создания цепочки.

Авторизация

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

  • https://mail.google.com/

См. также