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, используют его вместо обязательного аргумента body; вы можете добавить необязательное поле inlineImages в тело HTML, если у вас есть встроенные изображения для вашей электронной почты
inlineImages Object объект JavaScript, содержащий сопоставление ключа изображения ( String ) с данными изображения ( BlobSource ); это предполагает, что параметр htmlBody используется и содержит ссылки на эти изображения в формате <img src="cid:imageKey" />
name String имя отправителя электронного письма (по умолчанию: имя пользователя)
replyTo String адрес электронной почты для использования в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)
subject String новая тема письма

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

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, используют его вместо обязательного аргумента body; вы можете добавить необязательное поле inlineImages в тело HTML, если у вас есть встроенные изображения для вашей электронной почты
inlineImages Object объект JavaScript, содержащий сопоставление ключа изображения ( String ) с данными изображения ( BlobSource ); это предполагает, что параметр htmlBody используется и содержит ссылки на эти изображения в формате <img src="cid:imageKey" />
name String имя отправителя электронного письма (по умолчанию: имя пользователя)
replyTo String адрес электронной почты для использования в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)
subject String новая тема письма

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

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, используют его вместо обязательного аргумента body; вы можете добавить необязательное поле inlineImages в тело HTML, если у вас есть встроенные изображения для вашей электронной почты
inlineImages Object объект JavaScript, содержащий сопоставление ключа изображения ( String ) с данными изображения ( BlobSource ); это предполагает, что параметр htmlBody используется и содержит ссылки на эти изображения в формате <img src="cid:imageKey" />
name String имя отправителя электронного письма (по умолчанию: имя пользователя)
noReply Boolean true , если электронное письмо должно быть отправлено с общего адреса электронной почты, на который не отвечают, чтобы получатели не отвечали на электронные письма; этот вариант возможен только для учетных записей Google Workspace, но не для пользователей Gmail.
replyTo String адрес электронной почты для использования в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)
subject String новая тема письма

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

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, используют его вместо обязательного аргумента body; вы можете добавить необязательное поле inlineImages в тело HTML, если у вас есть встроенные изображения для вашей электронной почты
inlineImages Object объект JavaScript, содержащий сопоставление ключа изображения ( String ) с данными изображения ( BlobSource ); это предполагает, что параметр htmlBody используется и содержит ссылки на эти изображения в формате <img src="cid:imageKey" />
name String имя отправителя электронного письма (по умолчанию: имя пользователя)
noReply Boolean true , если электронное письмо должно быть отправлено с общего адреса электронной почты, на который не отвечают, чтобы получатели не отвечали на электронные письма; этот вариант возможен только для учетных записей Google Workspace, но не для пользователей Gmail.
replyTo String адрес электронной почты для использования в качестве адреса для ответа по умолчанию (по умолчанию: адрес электронной почты пользователя)
subject String новая тема письма

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

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, используют его вместо обязательного аргумента body; вы можете добавить необязательное поле 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/

Смотрите также