Class GmailThread

Adiciona este rótulo à conversa.

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

Parâmetros

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Consulte também

• removeLabel(label)

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

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

Parâmetros

Retornar

GmailDraft: o rascunho de mensagem recém-criado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos ou escopos adequados 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 que responde ao remetente da última mensagem nesta conversa usando o endereço de resposta, com argumentos opcionais.

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

// 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',
});

Parâmetros

Parâmetros avançados

Retornar

GmailDraft: o rascunho de mensagem recém-criado

Autorização

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

• https://mail.google.com/

Consulte também

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

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

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

Parâmetros

Retornar

GmailDraft: o rascunho de mensagem recém-criado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos ou escopos adequados 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 que responde ao remetente da última mensagem nesta conversa, usando o endereço de 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) é limitado pela 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.
const 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: o rascunho de mensagem recém-criado

Autorização

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

• https://mail.google.com/

Consulte também

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

Recebe o assunto da primeira mensagem na conversa.

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

Retornar

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 adequados da API REST relacionada:

• https://mail.google.com/

Consulte também

• getLastMessageDate()

Recebe o ID desta linha de execução. O ID de uma conversa varia com base nas mensagens que ela contém. Para um ID consistente de uma mensagem específica na conversa, chame 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

Retornar

String: o ID da linha de execução

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

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

Retornar

GmailLabel[]: uma matriz de rótulos para esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Recebe a data da mensagem mais recente desta conversa.

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

Retornar

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 adequados 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
const 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 exigem autorização com um ou mais dos seguintes escopos ou escopos adequados 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
const messages = firstThread.getMessages();
for (let 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 exigem autorização com um ou mais dos seguintes escopos ou escopos adequados da API REST relacionada:

• https://mail.google.com/

Consulte também

• getMessageCount()

Recebe um link permanente para essa conversa.

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

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

Retornar

String: o link permanente dessa conversa

Retorna se a conversa tem mensagens marcadas com estrela.

// Log if this thread has starred messages
const 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 exigem autorização com um ou mais dos seguintes escopos ou escopos adequados 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
Logger.log(`Important? : ${firstThread.isImportant()}`);

Retornar

Boolean: indica 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 adequados da API REST relacionada:

• https://mail.google.com/

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

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

Retornar

Boolean: verdadeiro se a linha de conversa for marcada como uma conversa

Autorização

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

• https://mail.google.com/

Retorna verdadeiro se a linha de execução estiver na caixa de entrada prioritária. Caso contrário, retorna falso.

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

Retornar

Boolean: verdadeiro se a linha de execução estiver na caixa de entrada prioritária.

Autorização

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

• https://mail.google.com/

Retorna se a linha de execução está na lixeira.

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

Retornar

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 adequados da API REST relacionada:

• https://mail.google.com/

Retorna se a conversa tem mensagens não lidas.

// Log if this thread is unread
const 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 exigem autorização com um ou mais dos seguintes escopos ou escopos adequados da API REST relacionada:

• https://mail.google.com/

Marca esta conversa como importante.

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

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Consulte também

• markUnimportant()

Marca esta conversa como lida.

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

Retornar

GmailThread: esta 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 adequados 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markUnimportant();

Retornar

GmailThread: esta 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 adequados 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.markUnread();

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Consulte também

• markRead()

Move essa linha de execução para o arquivo.

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

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Move essa conversa para a caixa de entrada.

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

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Move essa conversa para a caixa de spam.

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

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Move a conversa para a lixeira.

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

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Recarrega esta conversa e o estado associado do Gmail (útil caso os rótulos, o estado de leitura etc. tenham mudado).

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

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Remove esse rótulo da conversa.

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

Parâmetros

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Consulte 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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.reply('Got your message');

Parâmetros

Retornar

GmailThread: esta 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 adequados 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 nesta conversa usando o endereço replyTo com argumentos opcionais. O e-mail pode conter texto simples e um corpo HTML. 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.
const 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: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Consulte 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 desta conversação.

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
const firstThread = GmailApp.getInboxThreads(0, 1)[0];
firstThread.replyAll('Got your message');

Parâmetros

Retornar

GmailThread: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Consulte 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 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.
const 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: esta 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 adequados da API REST relacionada:

• https://mail.google.com/

Consulte também

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