Class GmailThread

Adiciona esse marcador à conversa.

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

Parâmetros

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• removeLabel(label)

Cria uma mensagem de rascunho respondendo ao remetente da última mensagem nesta conversa usando o endereço para resposta. O tamanho do e-mail (incluindo cabeçalhos) é limitado pela cota.

// Create a draft reply to the message author with an acknowledgement.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReply("Got your message");

Parâmetros

Retornar

GmailDraft: a mensagem de rascunho recém-criada.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

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

Cria uma mensagem de rascunho respondendo ao remetente da última mensagem nesta conversa usando o endereço para resposta, com argumentos opcionais.

O e-mail pode conter texto simples e um corpo HTML. O tamanho do e-mail (incluindo cabeçalhos) é cota limitada.

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

Parâmetros

Parâmetros avançados

Retornar

GmailDraft: a mensagem de rascunho recém-criada.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

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

Cria uma mensagem de rascunho respondendo ao remetente da última mensagem nesta conversa usando o método endereço para resposta e todos os destinatários desta mensagem. O tamanho do e-mail (incluindo cabeçalhos) for uma cota limitada.

// Create a draft reply to all recipients (except those bcc'd) of the last email in this
// thread.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var message = firstThread.getMessages()[0];
message.createDraftReplyAll("Got your message");

Parâmetros

Retornar

GmailDraft: a mensagem de rascunho recém-criada.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

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

Cria uma mensagem de rascunho respondendo ao remetente da última mensagem nesta conversa usando o método endereço para resposta e todos os destinatários, com argumentos opcionais.

O e-mail pode conter texto simples e um corpo HTML. O tamanho do e-mail (incluindo cabeçalhos) é cota limitada.

// Create a draft reply, using an HTML text body, to all recipients (except those bcc'd) of
// the last email of in this thread.
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.createDraftReplyAll("incapable of HTML", {
  htmlBody: "<b>some HTML body text</b>",
  cc: "another@example.com"
});

Parâmetros

Parâmetros avançados

Retornar

GmailDraft: a mensagem de rascunho recém-criada.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

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

Extrai o assunto da primeira mensagem na conversa.

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

Retornar

String: o assunto da primeira mensagem da conversa.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• getLastMessageDate()

Extrai o ID desta sequência. O ID de um thread varia de acordo com as mensagens que ele contém. para um ID consistente para uma mensagem específica na linha de execução, chame getMessages()[0].getId(). como alternativa.

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

Retornar

String: o ID desta conversa.

Retorna os rótulos criados pelo usuário na linha de execução.

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

Retornar

GmailLabel[]: uma matriz de rótulos para esta linha de execução.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Acessa a data da mensagem mais recente desta conversa.

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

Retornar

Date: a data da mensagem mais recente na conversa.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• getFirstMessageSubject()

Retorna o número de mensagens na conversa.

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

Retornar

Integer: o número de mensagens na conversa

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• getMessages()

Recebe as mensagens desta conversa.

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

Retornar

GmailMessage[]: uma matriz de mensagens do Gmail nesta conversa

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• getMessageCount()

Recebe um link permanente para esta conversa.

Isso só funciona na interface clássica do Gmail, não na Caixa de entrada.

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

Retornar

String: o link permanente desta conversa

Retorna se a conversa tem mensagens marcadas com estrela.

// Log if this thread has starred messages
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('has starred : ' + firstThread.hasStarredMessages());

Retornar

Boolean: verdadeiro se a conversa tiver mensagens marcadas com estrela.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Retorna indicando se a conversa está marcada como importante.

// Log if this thread is marked as important
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Important? : ' + firstThread.isImportant());

Retornar

Boolean: se a linha de execução está marcada como importante.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Retorna indicando se a conversa está marcada como um chat.

// Log if this thread is a chat
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in chats? : ' + firstThread.isInChats());

Retornar

Boolean: verdadeiro se a conversa estiver marcada como um chat.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Retorna indicando se a conversa está na caixa de entrada.

// Log if this thread is in the inbox
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in the inbox? : ' + firstThread.isInInbox());

Retornar

Boolean: verdadeiro se a conversa estiver na Caixa de entrada

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Retorna true se a conversa estiver na caixa de entrada prioritária; retorna falso, caso contrário.

// Log if this thread is in the priority inbox
var firstThread = GmailApp.getPriorityInboxThreads(0,1)[0];
Logger.log("is in priority inbox? " + firstThread.isInPriorityInbox());

Retornar

Boolean: verdadeiro se a conversa estiver na Caixa prioritária

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Informa se a conversa está marcada como spam.

// Log if this thread is in the spam folder
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Spam? ' + firstThread.isInSpam());

Retornar

Boolean: indica se a conversa está marcada como spam.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Informa se a conversa está na lixeira.

// Log if this thread is in the trash
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Trashed? ' + firstThread.isInTrash());

Retornar

Boolean: verdadeiro se a conversa estiver na lixeira

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Retorna se a conversa tem mensagens não lidas.

// Log if this thread is unread
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Unread? ' + firstThread.isUnread());

Retornar

Boolean: verdadeiro se houver mensagens não lidas

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Marca esta conversa como importante.

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

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• markUnimportant()

Marca esta conversa como lida.

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

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• markUnread()

Marca esta conversa como não importante.

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

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• markImportant()

Marca esta conversa como não lida.

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

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• markRead()

Move esta conversa para o arquivo.

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

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Move esta conversa para a caixa de entrada.

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

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Move esta conversa para a caixa de spam.

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

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Move esta conversa para a lixeira.

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

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Recarrega esta conversa e o estado associado pelo Gmail. Isso é útil caso os marcadores, o estado de leitura etc., foram alterados).

var 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 ...

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Remove o marcador da conversa.

var myLabel = GmailApp.getUserLabelByName('<your label>');
var threads = myLabel.getThreads();
for (var x in threads) {
  var thread = threads[x];
  thread.removeLabel(myLabel);
}

Parâmetros

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

• addLabel(label)

Responda ao remetente da última mensagem nesta conversa usando o endereço "replyTo".

Observe que o tamanho total do e-mail (incluindo todos os cabeçalhos) não pode exceder 20 KB.

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

Parâmetros

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

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

Responda ao remetente da última mensagem desta conversa usando o endereço "respondTo", com opções . O e-mail pode conter texto simples e também um corpo HTML. O valor total do e-mail (incluindo todos os cabeçalhos, mas excluindo anexos) não pode exceder 20 KB.

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

Parâmetros

Parâmetros avançados

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

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

Responder ao remetente (usando o endereço "respondTo") e a todos os destinatários da última mensagem neste fio

Observe que o tamanho total do e-mail (incluindo todos os cabeçalhos) não pode exceder 20 KB.

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

Parâmetros

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

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

Responder ao remetente (usando o endereço replyTo) e a todos os destinatários da última mensagem nesta linha de execução, com argumentos opcionais. O e-mail pode conter texto simples e também um Corpo HTML. Observe que o tamanho total do e-mail (incluindo todos os cabeçalhos, mas excluindo anexos) não pode exceder 20 KB.

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

Parâmetros

Parâmetros avançados

Retornar

GmailThread: linha de execução, útil para encadeamento.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

• https://mail.google.com/

Consulte também

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