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

Retorno

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

Autorização

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

• https://mail.google.com/

Veja também

• removeLabel(label)

Cria um rascunho para responder ao remetente da última mensagem nesta conversa usando o endereço para resposta. O tamanho do e-mail (incluindo os cabeçalhos) é limitado por 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

Retorno

GmailDraft: o rascunho da mensagem recém-criada.

Autorização

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

• https://mail.google.com/

Veja 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 corpo HTML. O tamanho do e-mail (incluindo os cabeçalhos) é limitado por cota.

// 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

Retorno

GmailDraft: o rascunho da mensagem recém-criada.

Autorização

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

• https://mail.google.com/

Veja também

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

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

// 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

Retorno

GmailDraft: o rascunho da mensagem recém-criada.

Autorização

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

• https://mail.google.com/

Veja 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 endereço para resposta e todos os destinatários, com argumentos opcionais.

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

// 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

Retorno

GmailDraft: o rascunho da mensagem recém-criada.

Autorização

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

• https://mail.google.com/

Veja também

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

Extrai o assunto da primeira mensagem da 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());

Retorno

String: o assunto da primeira mensagem na conversa.

Autorização

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

• https://mail.google.com/

Veja também

• getLastMessageDate()

Extrai o ID dessa linha de execução. O ID de uma linha de execução varia de acordo com as mensagens que ela contém. Para um ID consistente para uma determinada mensagem na linha de execução, chame getMessages()[0].getId().

// 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

Retorno

String: o ID desta linha de execução.

Retorna os rótulos criados pelo usuário nessa 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());
}

Retorno

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

Autorização

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

• https://mail.google.com/

Extrai a data da mensagem mais recente dessa 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());

Retorno

Date: a data da mensagem mais recente na conversa

Autorização

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

• https://mail.google.com/

Veja 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());

Retorno

Integer: o número de mensagens na conversa.

Autorização

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

• https://mail.google.com/

Veja também

• getMessages()

Recebe as mensagens nesta 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());
}

Retorno

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

Autorização

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

• https://mail.google.com/

Veja também

• getMessageCount()

Recebe um link permanente para esta conversa.

Observe que isso só funciona com a interface clássica do Gmail, não com o Inbox.

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

Retorno

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

Retorno

Boolean: verdadeiro se a conversa tiver mensagens com estrela.

Autorização

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

• https://mail.google.com/

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

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

Retorno

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

Autorização

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

• https://mail.google.com/

Retorna 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());

Retorno

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

Autorização

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

• https://mail.google.com/

Retorna 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());

Retorno

Boolean: verdadeiro se a conversa estiver na caixa de entrada.

Autorização

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

• https://mail.google.com/

Retorna "true" se essa conversa está na caixa de entrada prioritária. Caso contrário, retorna "false".

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

Retorno

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

Autorização

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

• https://mail.google.com/

Retorna 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());

Retorno

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

Autorização

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

• https://mail.google.com/

Retorna 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());

Retorno

Boolean: verdadeiro se a linha de execução estiver na lixeira.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos 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());

Retorno

Boolean: verdadeiro se houver mensagens não lidas.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos 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();

Retorno

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

Autorização

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

• https://mail.google.com/

Veja também

• markUnimportant()

Marca esta conversa como lida.

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

Retorno

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

Autorização

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

• https://mail.google.com/

Veja 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();

Retorno

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

Autorização

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

• https://mail.google.com/

Veja 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();

Retorno

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

Autorização

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

• https://mail.google.com/

Veja também

• markRead()

Move esta conversa para o arquivo.

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

Retorno

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

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos 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();

Retorno

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

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos 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();

Retorno

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

Autorização

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

• https://mail.google.com/

Move a conversa para a lixeira.

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

Retorno

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

Autorização

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

• https://mail.google.com/

Recarrega essa conversa e o estado associado do Gmail (útil caso os marcadores, o estado de leitura etc. tenham sido 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 ...

Retorno

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

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos 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

Retorno

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

Autorização

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

• https://mail.google.com/

Veja também

• addLabel(label)

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

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

Retorno

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

Autorização

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

• https://mail.google.com/

Veja também

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

Responda ao remetente da última mensagem nesta conversa usando o endereço "replyTo" 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, exceto os 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

Retorno

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

Autorização

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

• https://mail.google.com/

Veja também

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

Responda ao remetente usando o endereço "replyTo" e a todos os destinatários da última mensagem nesta conversa.

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

Retorno

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

Autorização

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

• https://mail.google.com/

Veja também

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

Responda ao remetente (usando o endereço replyTo) e a todos os destinatários da última mensagem nesta conversa, com argumentos opcionais. O e-mail pode conter texto simples e também um corpo HTML. O tamanho total do e-mail (incluindo todos os cabeçalhos, exceto 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

Retorno

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

Autorização

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

• https://mail.google.com/

Veja também

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