Class GmailThread

GmailThread

Ein E‑Mail-Verlauf im Gmail-Konto eines Nutzers.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
addLabel(label)	GmailThread	Fügt dem Thread dieses Label hinzu.
createDraftReply(body)	GmailDraft	Erstellt eine Nachricht als Antwort an den Absender der letzten Nachricht in diesem Thread unter Verwendung der Antwortadresse.
createDraftReply(body, options)	GmailDraft	Erstellt eine Nachricht als Antwort an den Absender der letzten Nachricht in diesem Thread mit der Antwortadresse und optionalen Argumenten.
createDraftReplyAll(body)	GmailDraft	Erstellt eine Nachricht, die auf den Absender der letzten Nachricht in diesem Thread antwortet. Dabei werden die Antwortadresse und alle Empfänger dieser Nachricht verwendet.
createDraftReplyAll(body, options)	GmailDraft	Erstellt eine Nachricht als Antwort auf den Absender der letzten Nachricht in diesem Thread. Dabei werden die Antwortadresse und alle Empfänger verwendet. Optionale Argumente sind möglich.
getFirstMessageSubject()	String	Ruft den Betreff der ersten Nachricht im Thread ab.
getId()	String	Gibt die ID dieses Threads zurück.
getLabels()	GmailLabel[]	Gibt die vom Nutzer erstellten Labels für diesen Thread zurück.
getLastMessageDate()	Date	Ruft das Datum der letzten Nachricht in diesem Thread ab.
getMessageCount()	Integer	Gibt die Anzahl der Nachrichten im Thread zurück.
getMessages()	GmailMessage[]	Ruft die Nachrichten in diesem Thread ab.
getPermalink()	String	Ruft einen Permalink für diesen Thread ab.
hasStarredMessages()	Boolean	Gibt zurück, ob der Thread mit Sternchen markierte Nachrichten enthält.
isImportant()	Boolean	Gibt zurück, ob der Thread als wichtig markiert ist.
isInChats()	Boolean	Gibt zurück, ob der Thread als Chat gekennzeichnet ist.
isInInbox()	Boolean	Gibt zurück, ob sich der Thread im Posteingang befindet.
isInPriorityInbox()	Boolean	Gibt „true“ zurück, wenn sich dieser Thread im Prioritätsposteingang befindet, andernfalls „false“.
isInSpam()	Boolean	Gibt zurück, ob die Unterhaltung als Spam markiert ist.
isInTrash()	Boolean	Gibt zurück, ob sich der Thread im Papierkorb befindet.
isUnread()	Boolean	Gibt zurück, ob der Thread ungelesene Nachrichten enthält.
markImportant()	GmailThread	Dieser Thread wird als wichtig markiert.
markRead()	GmailThread	Dieser Thread wird als gelesen markiert.
markUnimportant()	GmailThread	Markiert diesen Thread als unwichtig.
markUnread()	GmailThread	Markiert diesen Thread als ungelesen.
moveToArchive()	GmailThread	Verschiebt diesen Thread ins Archiv.
moveToInbox()	GmailThread	Verschiebt diesen Thread in den Posteingang.
moveToSpam()	GmailThread	Verschiebt diesen Thread in den Spamordner.
moveToTrash()	GmailThread	Dadurch wird dieser Thread in den Papierkorb verschoben.
refresh()	GmailThread	Lädt diesen Thread und den zugehörigen Status aus Gmail neu (nützlich, wenn sich die Labels, der Lesestatus usw. geändert haben).
removeLabel(label)	GmailThread	Entfernt dieses Label aus der Konversation.
reply(body)	GmailThread	Antworte dem Absender der letzten Nachricht in diesem Thread über die „replyTo“-Adresse.
reply(body, options)	GmailThread	Antworte dem Absender der letzten Nachricht in diesem Thread über die replyTo-Adresse mit optionalen Argumenten.
replyAll(body)	GmailThread	Antworten Sie dem Absender (über die „replyTo“-Adresse) und allen Empfängern der letzten Nachricht in diesem Thread.
replyAll(body, options)	GmailThread	Antworte dem Absender (mit der replyTo-Adresse) und allen Empfängern der letzten Nachricht in diesem Thread mit optionalen Argumenten.

Detaillierte Dokumentation

addLabel(label)

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

Name	Typ	Beschreibung
label	GmailLabel	Das Label, das auf diesen Thread angewendet werden soll

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• removeLabel(label)

---

createDraftReply(body)

Erstellt eine Nachricht als Antwort an den Absender der letzten Nachricht in diesem Thread unter Verwendung der Antwortadresse. Die Größe der E‑Mail (einschließlich Kopfzeilen) ist kontingentbeschränkt.

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

Parameter

Name	Typ	Beschreibung
body	String	den Text der E‑Mail

Rückflug

GmailDraft: Die neu erstellte Entwurfsnachricht

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

createDraftReply(body, options)

Erstellt eine Nachricht als Antwort an den Absender der letzten Nachricht in diesem Thread mit der Antwortadresse und optionalen Argumenten.

Die E‑Mail kann sowohl Nur-Text als auch einen HTML-Text enthalten. Die Größe der E‑Mail (einschließlich Kopfzeilen) ist kontingentbeschränkt.

// 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: '[e-mail]',
});

Parameter

Name	Typ	Beschreibung
body	String	den Text der E‑Mail
options	Object	Ein JavaScript-Objekt, das erweiterte Parameter angibt (siehe unten)

Erweiterte Parameter

Name	Typ	Beschreibung
attachments	BlobSource[]	ein Array von Dateien, die mit der E‑Mail gesendet werden sollen
bcc	String	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die in BCC gesetzt werden sollen
cc	String	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die in Cc gesetzt werden sollen
from	String	Die Adresse, von der die E-Mail gesendet werden soll. Sie muss einer der von GmailApp.getAliases() zurückgegebenen Werte sein.
htmlBody	String	Wenn dieser Parameter festgelegt ist, verwenden Geräte, die HTML rendern können, ihn anstelle des erforderlichen „body“-Arguments. Sie können dem HTML-Textkörper ein optionales inlineImages-Feld hinzufügen, wenn Sie Inline-Bilder für Ihre E-Mail haben.
inlineImages	Object	Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (String) zu den Bilddaten (BlobSource) enthält. Dies setzt voraus, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält.
name	String	Der Name des Absenders der E‑Mail (Standard: der Name des Nutzers)
replyTo	String	Eine E‑Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E‑Mail-Adresse des Nutzers)
subject	String	eine neue Betreffzeile für die E‑Mail (maximal 250 Zeichen)

Rückflug

GmailDraft: Die neu erstellte Entwurfsnachricht

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

createDraftReplyAll(body)

Erstellt eine Nachricht, die auf den Absender der letzten Nachricht in diesem Thread antwortet. Dabei werden die Antwortadresse und alle Empfänger dieser Nachricht verwendet. Die Größe der E‑Mail (einschließlich Kopfzeilen) ist kontingentbeschränkt.

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

Name	Typ	Beschreibung
body	String	den Text der E‑Mail

Rückflug

GmailDraft: Die neu erstellte Entwurfsnachricht

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

createDraftReplyAll(body, options)

Erstellt eine Nachricht als Antwort auf den Absender der letzten Nachricht in diesem Thread. Dabei werden die Antwortadresse und alle Empfänger verwendet. Optionale Argumente sind möglich.

Die E‑Mail kann sowohl Nur-Text als auch einen HTML-Text enthalten. Die Größe der E‑Mail (einschließlich Kopfzeilen) ist kontingentbeschränkt.

// 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: '[e-mail]',
});

Parameter

Name	Typ	Beschreibung
body	String	den Text der E‑Mail
options	Object	Ein JavaScript-Objekt, das erweiterte Parameter angibt (siehe unten)

Erweiterte Parameter

Name	Typ	Beschreibung
attachments	BlobSource[]	ein Array von Dateien, die mit der E‑Mail gesendet werden sollen
bcc	String	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die in BCC gesetzt werden sollen
cc	String	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die in Cc gesetzt werden sollen
from	String	Die Adresse, von der die E-Mail gesendet werden soll. Sie muss einer der von GmailApp.getAliases() zurückgegebenen Werte sein.
htmlBody	String	Wenn dieser Parameter festgelegt ist, verwenden Geräte, die HTML rendern können, ihn anstelle des erforderlichen „body“-Arguments. Sie können dem HTML-Textkörper ein optionales inlineImages-Feld hinzufügen, wenn Sie Inline-Bilder für Ihre E-Mail haben.
inlineImages	Object	Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (String) zu den Bilddaten (BlobSource) enthält. Dies setzt voraus, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält.
name	String	Der Name des Absenders der E‑Mail (Standard: der Name des Nutzers)
replyTo	String	Eine E‑Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E‑Mail-Adresse des Nutzers)
subject	String	einen neuen Betreff für die E‑Mail. Die maximale Größe beträgt 250 Zeichen.

Rückflug

GmailDraft: Die neu erstellte Entwurfsnachricht

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

getFirstMessageSubject()

Ruft den Betreff der ersten Nachricht im Thread ab.

// 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: Betreff der ersten Nachricht im Thread

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getLastMessageDate()

---

getId()

Gibt die ID dieses Threads zurück. Die ID eines Threads variiert je nach den darin enthaltenen Nachrichten. Wenn Sie eine konsistente 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

---

getLabels()

Gibt die vom Nutzer erstellten Labels für diesen Thread zurück.

// 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 diese Unterhaltung.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

getLastMessageDate()

Ruft das Datum der letzten Nachricht in diesem Thread ab.

// 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getFirstMessageSubject()

---

getMessageCount()

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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessages()

---

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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessageCount()

---

getPermalink()

Ruft einen Permalink für diesen Thread ab.

Diese Funktion ist nur in der klassischen Gmail-Oberfläche verfügbar, nicht in 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 diese Unterhaltung

---

hasStarredMessages()

Gibt zurück, ob der Thread mit Sternchen 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: „true“, wenn die Konversation markierte Nachrichten enthält

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

isImportant()

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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

isInChats()

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 – „true“, wenn der Thread als Chat gekennzeichnet ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

isInInbox()

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: „true“, wenn sich der Thread im Posteingang befindet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

isInPriorityInbox()

Gibt „true“ zurück, wenn sich dieser Thread im Prioritätsposteingang befindet, andernfalls „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()}`);

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

isInSpam()

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 diese Unterhaltung als Spam markiert ist.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

isInTrash()

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 – „true“, wenn sich der Thread im Papierkorb befindet

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

isUnread()

Gibt zurück, 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 – „true“, wenn ungelesene Nachrichten vorhanden sind

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

markImportant()

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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markUnimportant()

---

markRead()

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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markUnread()

---

markUnimportant()

Markiert diesen Thread als unwichtig.

// 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markImportant()

---

markUnread()

Markiert diesen Thread als ungelesen.

// 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markRead()

---

moveToArchive()

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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

moveToInbox()

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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

moveToSpam()

Verschiebt diesen Thread in den Spamordner.

// 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

moveToTrash()

Dadurch wird dieser Thread 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

refresh()

Lädt diesen Thread und den zugehörigen Status aus Gmail neu (nützlich, wenn sich die Labels, der Lesestatus usw. 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, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

---

removeLabel(label)

Entfernt dieses Label aus der Konversation.

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

Parameter

Name	Typ	Beschreibung
label	GmailLabel	Das Label, das aus dieser Konversation entfernt werden soll

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• addLabel(label)

---

reply(body)

Antworte dem Absender der letzten Nachricht in diesem Thread über die 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

Name	Typ	Beschreibung
body	String	den Text der E‑Mail

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

reply(body, options)

Antworte dem Absender der letzten Nachricht in diesem Thread über die replyTo-Adresse mit optionalen Argumenten. Die E‑Mail kann sowohl Nur-Text als auch einen HTML-Text 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.reply('incapable of HTML', {
  htmlBody: 'some HTML body text',
  noReply: true,
});

Parameter

Name	Typ	Beschreibung
body	String	den Text der E‑Mail
options	Object	Ein JavaScript-Objekt, das erweiterte Parameter angibt (siehe unten)

Erweiterte Parameter

Name	Typ	Beschreibung
cc	String	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die in Cc gesetzt werden sollen
bcc	String	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die auf BCC gesetzt werden sollen
htmlBody	String	Wenn dieser Parameter festgelegt ist, verwenden Geräte, die HTML rendern können, ihn anstelle des erforderlichen „body“-Arguments. Sie können dem HTML-Textkörper ein optionales inlineImages-Feld hinzufügen, wenn Sie Inline-Bilder für Ihre E-Mail haben.
name	String	Der Name des Absenders der E‑Mail (Standard: der Name des Nutzers)
from	String	Die Adresse, von der die E-Mail gesendet werden soll. Sie muss einer der von GmailApp.getAliases() zurückgegebenen Werte sein.
replyTo	String	Eine E‑Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E‑Mail-Adresse des Nutzers)
noReply	Boolean	true, wenn die E‑Mail von einer allgemeinen „Nicht antworten“-E‑Mail-Adresse gesendet werden soll, um Empfänger davon abzuhalten, auf E‑Mails zu antworten. Diese Option ist nur für Google Workspace-Konten verfügbar, nicht für Gmail-Nutzer.
attachments	BlobSource[]	ein Array von Dateien, die mit der E‑Mail gesendet werden sollen
inlineImages	Object	Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (String) zu den Bilddaten (BlobSource) enthält. Dies setzt voraus, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

replyAll(body)

Antworten Sie dem Absender (über die „replyTo“-Adresse) und allen Empfängern 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

Name	Typ	Beschreibung
body	String	den Text der E‑Mail

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

replyAll(body, options)

Antworte dem Absender (mit der replyTo-Adresse) und allen Empfängern der letzten Nachricht in diesem Thread mit optionalen Argumenten. Die E-Mail kann sowohl Nur-Text als auch einen HTML-Text 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

Name	Typ	Beschreibung
body	String	den Text der E‑Mail
options	Object	Ein JavaScript-Objekt, das erweiterte Parameter angibt (siehe unten)

Erweiterte Parameter

Name	Typ	Beschreibung
cc	String	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die in Cc gesetzt werden sollen
bcc	String	Eine durch Kommas getrennte Liste der E‑Mail-Adressen, die auf BCC gesetzt werden sollen
htmlBody	String	Wenn dieser Parameter festgelegt ist, verwenden Geräte, die HTML rendern können, ihn anstelle des erforderlichen „body“-Arguments. Sie können dem HTML-Textkörper ein optionales inlineImages-Feld hinzufügen, wenn Sie Inline-Bilder für Ihre E-Mail haben.
name	String	Der Name des Absenders der E‑Mail (Standard: der Name des Nutzers)
from	String	Die Adresse, von der die E-Mail gesendet werden soll. Sie muss einer der von GmailApp.getAliases() zurückgegebenen Werte sein.
replyTo	String	Eine E‑Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E‑Mail-Adresse des Nutzers)
noReply	Boolean	true, wenn die E‑Mail von einer allgemeinen „Nicht antworten“-E‑Mail-Adresse gesendet werden soll, um Empfänger davon abzuhalten, auf E‑Mails zu antworten. Diese Option ist nur für G Suite-Konten verfügbar, nicht für Gmail-Nutzer.
attachments	BlobSource[]	ein Array von Dateien, die mit der E‑Mail gesendet werden sollen
inlineImages	Object	Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (String) zu den Bilddaten (BlobSource) enthält. Dies setzt voraus, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält.

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche oder entsprechende Zugriffsbereiche aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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