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');

Параметры

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

Gmail Draft — вновь созданный черновик сообщения.

Авторизация

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

• https://mail.google.com/

См. также

• reply(body)
• create Draft Reply(body, options)
• create Draft Reply All(body)
• create Draft Reply All(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',
});

Параметры

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

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

Gmail Draft — вновь созданный черновик сообщения.

Авторизация

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

• https://mail.google.com/

См. также

• reply(body, options)
• create Draft Reply(body)
• create Draft Reply All(body)
• create Draft Reply All(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');

Параметры

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

Gmail Draft — вновь созданный черновик сообщения.

Авторизация

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

• https://mail.google.com/

См. также

• reply All(body)
• create Draft Reply(body)
• create Draft Reply(body, options)
• create Draft Reply All(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',
});

Параметры

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

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

Gmail Draft — вновь созданный черновик сообщения.

Авторизация

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

• https://mail.google.com/

См. также

• reply All(body, options)
• create Draft Reply(body)
• create Draft Reply(body, options)
• create Draft Reply All(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');

Параметры

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

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

Авторизация

Сценарии, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего 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',
});

Параметры

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• forward(recipient)

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

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

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

Авторизация

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

• https://mail.google.com/

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

Параметры

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

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

Gmail Attachment[] — массив вложений 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/

См. также

• get To()

Получает 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/

См. также

• get Subject()

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

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/

См. также

• get To()

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

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/

См. также

• get Reply To()

Получает значение заголовка 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/

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

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. Это сложнее, чем get Body() , и занимает больше времени.

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/

См. также

• get Subject()

Получает необработанное содержимое этого сообщения. Это эквивалентно функции «Показать оригинал» в пользовательском интерфейсе 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/

См. также

• get Cc()

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

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/

См. также

• get Attachments()

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

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

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

Gmail Thread — 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/

См. также

• get Cc()

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• is Unread()

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• is Unread()

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

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• is In Trash()

Перезагружает это сообщение и связанное с ним состояние из 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

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

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

Авторизация

Сценарии, использующие этот метод, требуют авторизации с использованием одной или нескольких из следующих областей или соответствующих областей из соответствующего 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');

Параметры

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

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

Авторизация

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

• https://mail.google.com/

См. также

• reply(body, options)
• reply All(body)
• reply All(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,
});

Параметры

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• reply(body)
• reply All(body)
• reply All(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');

Параметры

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

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

Авторизация

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

• https://mail.google.com/

См. также

• reply(body)
• reply(body, options)
• reply All(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,
});

Параметры

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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• reply(body)
• reply(body, options)
• reply All(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

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

Gmail Message — это сообщение 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

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

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

Авторизация

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

• https://mail.google.com/

См. также

• star()