Class GmailMessage

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

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

Параметры

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

GmailDraft — Только что созданное черновик сообщения.

Авторизация

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

• https://mail.google.com/

См. также

• reply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

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

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

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

Параметры

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

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

GmailDraft — Только что созданное черновик сообщения.

Авторизация

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

• https://mail.google.com/

См. также

• reply(body, options)
• createDraftReply(body)
• createDraftReplyAll(body)
• createDraftReplyAll(body, options)

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

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

Параметры

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

GmailDraft — Только что созданное черновик сообщения.

Авторизация

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

• https://mail.google.com/

См. также

• replyAll(body)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body, options)

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

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

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

Параметры

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

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

GmailDraft — Только что созданное черновик сообщения.

Авторизация

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

• https://mail.google.com/

См. также

• replyAll(body, options)
• createDraftReply(body)
• createDraftReply(body, options)
• createDraftReplyAll(body)

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

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

Параметры

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

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

Авторизация

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

• https://mail.google.com/

См. также

• forward(recipient, options)

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

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

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

Параметры

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• forward(recipient)

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

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

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

Авторизация

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

• https://mail.google.com/

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

Параметры

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

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

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

Авторизация

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

• https://mail.google.com/

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

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• getTo()

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• getSubject()

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• getTo()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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/

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• getReplyTo()

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

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

Параметры

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

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

Авторизация

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

• https://mail.google.com/

Gets the ID of this message.

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

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

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

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• getSubject()

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

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

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

Авторизация

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

• https://mail.google.com/

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• getCc()

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

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

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

String — Тема данного сообщения.

Авторизация

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

• https://mail.google.com/

См. также

• getAttachments()

Gets the thread that contains this message.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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/

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• getCc()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is draft? ${message.isDraft()}`);

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

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

Авторизация

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

• https://mail.google.com/

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is a chat? ${message.isInChats()}`);

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

Boolean — указывает, является ли это сообщение сообщением в чате.

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in inbox? ${message.isInInbox()}`);

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

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

Авторизация

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

• https://mail.google.com/

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

const thread = GmailApp.getPriorityInboxThreads(
    0, 1)[0];  // Get first thread in priority inbox
const messages = thread.getMessages();
for (let 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/

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is in the trash? ${message.isInTrash()}`);

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

Boolean — Указывает, будет ли это сообщение отправлено в корзину.

Выводит информацию о том, отмечено ли это сообщение звездочкой.

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is starred? ${message.isStarred()}`);

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

Boolean — Помечено ли это сообщение звездочкой.

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const message = thread.getMessages()[0];           // Get first message
Logger.log(`is unread? ${message.isUnread()}`);

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

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

Авторизация

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

• https://mail.google.com/

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• isUnread()

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• isUnread()

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• isInTrash()

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

const thread = GmailApp.getInboxThreads(0, 1)[0];  // Get first thread in inbox
const 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/

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

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

Параметры

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

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

Авторизация

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

• https://mail.google.com/

См. также

• reply(body, options)
• replyAll(body)
• replyAll(body, options)

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

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

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

Параметры

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• reply(body)
• replyAll(body)
• replyAll(body, options)

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

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

Параметры

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

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

Авторизация

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

• https://mail.google.com/

См. также

• reply(body)
• reply(body, options)
• replyAll(body, options)

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

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

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

Параметры

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• reply(body)
• reply(body, options)
• replyAll(body)

Отмечает сообщение звездочками.

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• unstar()

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• star()