Class GmailThread

Добавляет эту метку к теме обсуждения.

// Add label MyLabel to the first thread in the inbox
const label = GmailApp.getUserLabelByName('MyLabel');
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.addLabel(label);

Параметры

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

• removeLabel(label)

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

// Create a draft reply to the message author with an acknowledgement.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.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];
firstThread.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 reply to all recipients (except those bcc'd) of the last email
// in this thread.
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 reply, using an HTML text body, to all recipients (except
// those bcc'd) of the last email of in this thread.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.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)

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

// Log the subject of the first message in the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getFirstMessageSubject());

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

String — тема первого сообщения в этой ветке обсуждения.

Авторизация

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

• https://mail.google.com/

См. также

• getLastMessageDate()

Получает идентификатор этого потока. Идентификатор потока меняется в зависимости от содержащихся в нем сообщений; для получения согласованного идентификатора для конкретного сообщения в потоке вызовите вместо этого getMessages()[0].getId() .

// Log the subject of the first message in the first thread in the inbox.
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const id = firstThread.getId();
// Get same thread by its ID.
const thread = GmailApp.getThreadById(id);
Logger.log(
    thread.getFirstMessageSubject() === firstThread.getFirstMessageSubject(),
);  // True

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

String — идентификатор этой ветки обсуждения.

Возвращает созданные пользователем метки в этой ветке обсуждения.

// Log the names of the labels attached to the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const labels = firstThread.getLabels();
for (let i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

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

GmailLabel[] — массив меток для этой ветки обсуждения

Авторизация

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

• https://mail.google.com/

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

// Log the date of the most recent message on the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getLastMessageDate());

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

Date — дата последнего сообщения в ветке обсуждения.

Авторизация

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

• https://mail.google.com/

См. также

• getFirstMessageSubject()

Возвращает количество сообщений в потоке.

// Log the number of messages in the thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(firstThread.getMessageCount());

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

Integer — количество сообщений в цепочке.

Авторизация

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

• https://mail.google.com/

См. также

• getMessages()

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

// Log the subjects of the messages in the thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const messages = firstThread.getMessages();
for (let i = 0; i < messages.length; i++) {
  Logger.log(messages[i].getSubject());
}

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

GmailMessage[] — массив сообщений Gmail в этой ветке обсуждения

Авторизация

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

• https://mail.google.com/

См. также

• getMessageCount()

Эта ветка обсуждения получает постоянную ссылку.

Обратите внимание, что это работает только с классическим интерфейсом Gmail, а не с папкой «Входящие».

// Logs the permalink for the first thread in the inbox
const thread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(thread.getPermalink());

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

String — постоянная ссылка на эту ветку обсуждения

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

// Log if this thread has starred messages
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`has starred : ${firstThread.hasStarredMessages()}`);

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

Boolean — true, если в ветке есть сообщения, помеченные звездочкой.

Авторизация

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

• https://mail.google.com/

Возвращает значение, указывающее, помечена ли тема как важная.

// Log if this thread is marked as important
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Important? : ${firstThread.isImportant()}`);

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

Boolean — Указывает, помечена ли тема как важная.

Авторизация

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

• https://mail.google.com/

Возвращает значение, указывающее, помечен ли поток как чат.

// Log if this thread is a chat
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in chats? : ${firstThread.isInChats()}`);

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

Boolean — true, если ветка помечена как чат.

Авторизация

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

• https://mail.google.com/

Возвращает значение true, если ветка обсуждения находится во входящих сообщениях.

// Log if this thread is in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`is in the inbox? : ${firstThread.isInInbox()}`);

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

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

Авторизация

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

• https://mail.google.com/

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

// Log if this thread is in the priority inbox
const firstThread = GmailApp.getPriorityInboxThreads(0, 1)[0];
Logger.log(`is in priority inbox? ${firstThread.isInPriorityInbox()}`);

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

Boolean — true, если ветка находится в приоритетной папке входящих сообщений.

Авторизация

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

• https://mail.google.com/

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

// Log if this thread is in the spam folder
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Spam? ${firstThread.isInSpam()}`);

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

Boolean — Помечена ли эта ветка обсуждения как спам.

Авторизация

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

• https://mail.google.com/

Возвращает значение true, если поток находится в корзине.

// Log if this thread is in the trash
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Trashed? ${firstThread.isInTrash()}`);

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

Boolean — true, если нить находится в корзине.

Авторизация

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

• https://mail.google.com/

Возвращает значение, указывающее, есть ли у потока непрочитанные сообщения.

// Log if this thread is unread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Unread? ${firstThread.isUnread()}`);

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

Boolean — истинно, если есть непрочитанные сообщения.

Авторизация

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

• https://mail.google.com/

Помечает эту тему как важную.

// Mark first inbox thread as important
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markImportant();

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

• markUnimportant()

Помечает эту ветку как прочитанную.

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

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

• markUnread()

Помечает эту тему как неважную.

// Mark first inbox thread as unimportant
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markUnimportant();

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

• markImportant()

Помечает эту ветку обсуждения как непрочитанную.

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

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

• markRead()

Перемещает эту тему в архив.

// Archive first inbox thread
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToArchive();

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

Перемещает эту ветку обсуждения во входящие.

// Move first non-inbox thread to inbox
const firstThread = GmailApp.search('-in:inbox')[0];
firstThread.moveToInbox();

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

Перемещает эту тему в спам.

// Move first inbox thread to spam
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.moveToSpam();

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

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

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

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

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

const firstThread = GmailApp.getInboxThreads(0, 1)[0];
// ...Do something that may take a while here....
firstThread.refresh();  // Make sure it's up-to-date
// ...Do more stuff with firstThread ...

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

Удаляет эту метку из темы.

const myLabel = GmailApp.getUserLabelByName('<your label>');
const threads = myLabel.getThreads();
for (const thread of threads) {
  thread.removeLabel(myLabel);
}

Параметры

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

• addLabel(label)

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

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

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

Параметры

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

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

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

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

Параметры

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

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

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

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

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

// Respond to all with acknowledgment to the first thread in the inbox
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.replyAll('Got your message');

Параметры

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

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

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

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

Параметры

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

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

GmailThread — эта ветка обсуждений полезна для создания цепочек сообщений.

Авторизация

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

• https://mail.google.com/

См. также

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