Class GmailThread

Fügt dem Thread dieses Label hinzu.

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

Parameter

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• removeLabel(label)

Erstellt einen Entwurf einer Nachricht, in der der Absender der letzten Nachricht in diesem Thread mit der Antwortadresse antwortet wird. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.

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

Parameter

Rückflug

GmailDraft – der neu erstellte Nachrichtenentwurf

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Erstellt einen Entwurf einer Nachricht, die an den Absender der letzten Nachricht in diesem Thread mit der Rücksendeadresse und optionalen Argumenten geantwortet wird.

Die E-Mail kann sowohl Nur-Text als auch einen HTML-Textkörper enthalten. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.

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

Parameter

Erweiterte Parameter

Rückflug

GmailDraft – der neu erstellte Nachrichtenentwurf

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Erstellt einen Entwurf einer Nachricht, die an den Absender der letzten Nachricht in diesem Thread gerichtet ist. Dabei wird die Adresse für Antworten und alle Empfänger dieser Nachricht verwendet. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.

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

Parameter

Rückflug

GmailDraft – der neu erstellte Nachrichtenentwurf

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Erstellt einen Entwurf einer Nachricht, die an den Absender der letzten Nachricht in diesem Thread gerichtet ist. Dabei werden die Adresse für Antworten und alle Empfänger mit optionalen Argumenten verwendet.

Die E-Mail kann sowohl Nur-Text als auch einen HTML-Textkörper enthalten. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.

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

Parameter

Erweiterte Parameter

Rückflug

GmailDraft – der neu erstellte Nachrichtenentwurf

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Der Betreff der ersten Nachricht im Thread.

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

Rückflug

String – der Betreff der ersten Nachricht im Thread

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getLastMessageDate()

Ruft die ID dieses Threads ab. Die ID eines Threads variiert je nach den enthaltenen Nachrichten. Wenn Sie eine einheitliche ID für eine bestimmte Nachricht im Thread benötigen, rufen Sie stattdessen getMessages()[0].getId() auf.

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

Rückflug

String: die ID dieses Threads

Die von Nutzern erstellten Labels in diesem Thread.

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

Rückflug

GmailLabel[]: ein Array von Labels für diesen Thread

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Das Datum der letzten Nachricht in diesem Thread.

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

Rückflug

Date – das Datum der letzten Nachricht im Thread

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getFirstMessageSubject()

Gibt die Anzahl der Nachrichten im Thread zurück.

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

Rückflug

Integer – die Anzahl der Nachrichten im Thread

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessages()

Ruft die Nachrichten in diesem Thread ab.

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

Rückflug

GmailMessage[] – ein Array von Gmail-Nachrichten in diesem Thread

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessageCount()

Ruft einen Link zu diesem Thread ab.

Hinweis: Diese Funktion funktioniert nur mit der klassischen Gmail-Benutzeroberfläche, nicht mit Inbox.

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

Rückflug

String – der Permalink für diesen Thread

Gibt zurück, ob der Thread markierte Nachrichten enthält.

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

Rückflug

Boolean: „wahr“, wenn der Thread Nachrichten enthält, die Sie markiert haben

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Gibt zurück, ob der Thread als wichtig markiert ist.

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

Rückflug

Boolean: Gibt an, ob der Thread als wichtig markiert ist.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Gibt zurück, ob der Thread als Chat gekennzeichnet ist.

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

Rückflug

Boolean – „wahr“, wenn der Thread als Chat gekennzeichnet ist

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Gibt zurück, ob sich der Thread im Posteingang befindet.

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

Rückflug

Boolean: „wahr“, wenn sich der Thread im Posteingang befindet

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Gibt „wahr“ zurück, wenn sich dieser Thread im Posteingang mit Priorität befindet, andernfalls „falsch“.

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

Rückflug

Boolean – „wahr“, wenn sich der Thread im sortierten Eingang befindet

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Gibt zurück, ob die Unterhaltung als Spam markiert ist.

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

Rückflug

Boolean: Gibt an, ob dieser Thread als Spam markiert ist.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Gibt zurück, ob sich der Thread im Papierkorb befindet.

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

Rückflug

Boolean – „wahr“, wenn sich der Thread im Papierkorb befindet

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Gibt an, ob der Thread ungelesene Nachrichten enthält.

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

Rückflug

Boolean – „wahr“, wenn es ungelesene Nachrichten gibt

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Dieser Thread wird als wichtig markiert.

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

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markUnimportant()

Dieser Thread wird als gelesen markiert.

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

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markUnread()

Dieser Thread wird als unwichtig markiert.

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

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markImportant()

Dieser Thread wird als ungelesen markiert.

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

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markRead()

Verschiebt diesen Thread ins Archiv.

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

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Verschiebt diesen Thread in den Posteingang.

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

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Dieser Thread wird in den Spamordner verschoben.

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

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Dieser Thread wird in den Papierkorb verschoben.

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

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Dieser Thread und der zugehörige Status werden aus Gmail neu geladen. Das ist nützlich, wenn sich beispielsweise die Labels oder der Lesestatus geändert haben.

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

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Dadurch wird das Label aus der Konversation entfernt.

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

Parameter

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• addLabel(label)

Antworten Sie dem Absender der letzten Nachricht in diesem Thread mit der replyTo-Adresse.

Die Gesamtgröße der E-Mail (einschließlich aller Kopfzeilen) darf 20 KB nicht überschreiten.

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

Parameter

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Sie antworten dem Absender der letzten Nachricht in diesem Thread mit der replyTo-Adresse und optionalen Argumenten. Die E-Mail kann sowohl Nur-Text als auch einen HTML-Textkörper enthalten. Die Gesamtgröße der E-Mail (einschließlich aller Header, aber ohne Anhänge) darf 20 KB nicht überschreiten.

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

Parameter

Erweiterte Parameter

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Antworten Sie an den Absender (mit der replyTo-Adresse) und an alle Empfänger der letzten Nachricht in diesem Thread.

Die Gesamtgröße der E-Mail (einschließlich aller Kopfzeilen) darf 20 KB nicht überschreiten.

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

Parameter

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

Antworten Sie mit optionalen Argumenten an den Absender (mit der replyTo-Adresse) und alle Empfänger der letzten Nachricht in diesem Thread. Die E-Mail kann sowohl Nur-Text als auch einen HTML-Textkörper enthalten. Die Gesamtgröße der E-Mail (einschließlich aller Kopfzeilen, aber ohne Anhänge) darf 20 KB nicht überschreiten.

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

Parameter

Erweiterte Parameter

Rückflug

GmailThread – dieser Thread, nützlich für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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