Сообщение в учетной записи 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/