Class GmailThread

GmailThread

Ein Thread im Gmail-Konto eines Nutzers.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
addLabel(label)	GmailThread	Fügt dem Thread dieses Label hinzu.
createDraftReply(body)	GmailDraft	Erstellt einen Nachrichtenentwurf als Antwort an den Absender der letzten Nachricht in diesem Thread unter Verwendung der Antwortadresse.
createDraftReply(body, options)	GmailDraft	Erstellt einen Nachrichtenentwurf, der dem Absender der letzten Nachricht in diesem Thread unter Verwendung der Antwortadresse mit optionalen Argumenten antwortet.
createDraftReplyAll(body)	GmailDraft	Erstellt einen Nachrichtenentwurf als Antwort an den Absender der letzten Nachricht in diesem Thread, wobei die Antwortadresse und alle Empfänger dieser Nachricht verwendet werden.
createDraftReplyAll(body, options)	GmailDraft	Erstellt einen Nachrichtenentwurf als Antwort an den Absender der letzten Nachricht in diesem Thread, wobei die Antwortadresse und alle Empfänger mit optionalen Argumenten verwendet werden.
getFirstMessageSubject()	String	Ruft den Betreff der ersten Nachricht im Thread ab.
getId()	String	Ruft die ID dieses Threads ab.
getLabels()	GmailLabel[]	Gibt die vom Nutzer erstellten Labels für diesen Thread zurück.
getLastMessageDate()	Date	Ruft das Datum der neuesten Nachricht dieser Unterhaltung 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 markierte Nachrichten enthält.
isImportant()	Boolean	Gibt zurück, ob der Thread als wichtig markiert ist.
isInChats()	Boolean	Gibt zurück, ob der Thread das Label „Chat“ hat.
isInInbox()	Boolean	Gibt zurück, ob sich der Thread im Posteingang befindet.
isInPriorityInbox()	Boolean	Gibt „true“ zurück, wenn sich dieser Thread im sortierten Posteingang befindet. Andernfalls wird „false“ zurückgegeben.
isInSpam()	Boolean	Gibt zurück, ob der Thread als Spam markiert wurde.
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	Kennzeichnet diese Unterhaltung als wichtig.
markRead()	GmailThread	Markiert diesen Thread als gelesen.
markUnimportant()	GmailThread	Kennzeichnet diese Konversation als unwichtig.
markUnread()	GmailThread	Diese Unterhaltung wird als ungelesen markiert.
moveToArchive()	GmailThread	Verschiebt diese Unterhaltung in das Archiv.
moveToInbox()	GmailThread	Verschiebt diese Konversation in den Posteingang.
moveToSpam()	GmailThread	Verschiebt diese Unterhaltung in den Spamordner.
moveToTrash()	GmailThread	Verschiebt diese Konversation in den Papierkorb.
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 dem Thread.
reply(body)	GmailThread	Dem Absender der letzten Nachricht in dieser Unterhaltung mit der Adresse "responseTo" antworten.
reply(body, options)	GmailThread	Mit der Adresse "responseTo" antworten Sie dem Absender der letzten Nachricht in diesem Thread mit optionalen Argumenten.
replyAll(body)	GmailThread	Dem Absender (über die Adresse "responseTo") und allen Empfängern der letzten Nachricht in diesem Thread antworten.
replyAll(body, options)	GmailThread	Antworten Sie dem Absender (mit der Adresse replyTo) 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
var label = GmailApp.getUserLabelByName("MyLabel");
var firstThread = GmailApp.getInboxThreads(0,1)[0];
firstThread.addLabel(label);

Parameter

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• removeLabel(label)

---

createDraftReply(body)

Erstellt einen Nachrichtenentwurf als Antwort an den Absender der letzten Nachricht in diesem Thread unter Verwendung der Antwortadresse. Die Größe der E-Mail (einschließlich Header) ist begrenzt.

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

Parameter

Name	Typ	Beschreibung
body	String	Der E-Mail-Text

Return

GmailDraft: der neu erstellte Nachrichtenentwurf

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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 einen Nachrichtenentwurf, der dem Absender der letzten Nachricht in diesem Thread unter Verwendung der Antwortadresse mit optionalen Argumenten antwortet.

Die E-Mail kann sowohl Text als auch HTML-Text enthalten. Die Größe der E-Mail (einschließlich Header) ist begrenzt.

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

Parameter

Name	Typ	Beschreibung
body	String	Der E-Mail-Text
options	Object	Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt

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 von E-Mail-Adressen als Bcc
cc	String	eine durch Kommas getrennte Liste von E-Mail-Adressen, die in Cc gesetzt werden sollen
from	String	Die Adresse, von der die E-Mail gesendet werden soll. Diese muss einer der von GmailApp.getAliases() zurückgegebenen Werte sein.
htmlBody	String	Ist die Richtlinie festgelegt, verwenden Geräte, die HTML rendern können, dieses Argument anstelle des erforderlichen Textarguments. Wenn du Inline-Bilder für deine E-Mail hast, kannst du ein optionales inlineImages-Feld im HTML-Text hinzufügen.
inlineImages	Object	Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (String) zu Bilddaten (BlobSource) enthält. Dabei wird davon ausgegangen, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält.
name	String	den Namen des Absenders der E-Mail (Standard: der Name des Nutzers)
replyTo	String	eine E-Mail-Adresse, die als standardmäßige Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers)
subject	String	Eine neue Betreffzeile für die E-Mail (maximal 250 Zeichen)

Return

GmailDraft: der neu erstellte Nachrichtenentwurf

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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 einen Nachrichtenentwurf als Antwort an den Absender der letzten Nachricht in diesem Thread, wobei die Antwortadresse und alle Empfänger dieser Nachricht verwendet werden. Die Größe der E-Mail (einschließlich Header) ist begrenzt.

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

Parameter

Name	Typ	Beschreibung
body	String	Der E-Mail-Text

Return

GmailDraft: der neu erstellte Nachrichtenentwurf

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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 einen Nachrichtenentwurf als Antwort an den Absender der letzten Nachricht in diesem Thread, wobei die Antwortadresse und alle Empfänger mit optionalen Argumenten verwendet werden.

Die E-Mail kann sowohl Text als auch HTML-Text enthalten. Die Größe der E-Mail (einschließlich Header) ist begrenzt.

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

Parameter

Name	Typ	Beschreibung
body	String	Der E-Mail-Text
options	Object	Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt

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 von E-Mail-Adressen als Bcc
cc	String	eine durch Kommas getrennte Liste von E-Mail-Adressen, die in Cc gesetzt werden sollen
from	String	Die Adresse, von der die E-Mail gesendet werden soll. Diese muss einer der von GmailApp.getAliases() zurückgegebenen Werte sein.
htmlBody	String	Ist die Richtlinie festgelegt, verwenden Geräte, die HTML rendern können, dieses Argument anstelle des erforderlichen Textarguments. Wenn du Inline-Bilder für deine E-Mail hast, kannst du ein optionales inlineImages-Feld im HTML-Text hinzufügen.
inlineImages	Object	Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (String) zu Bilddaten (BlobSource) enthält. Dabei wird davon ausgegangen, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält.
name	String	den Namen des Absenders der E-Mail (Standard: der Name des Nutzers)
replyTo	String	eine E-Mail-Adresse, die als standardmäßige Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers)
subject	String	eine neue Betreffzeile für die E-Mail. Die maximale Größe beträgt 250 Zeichen.

Return

GmailDraft: der neu erstellte Nachrichtenentwurf

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getFirstMessageSubject());

Return

String: Betreff der ersten Nachricht im Thread

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getLastMessageDate()

---

getId()

Ruft die ID dieses Threads ab. Die ID eines Threads variiert je nach den darin enthaltenen Nachrichten. Um eine konsistente ID für eine bestimmte Nachricht im Thread zu erhalten, rufen Sie stattdessen getMessages()[0].getId() auf.

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

Return

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
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var labels = firstThread.getLabels();
for (var i = 0; i < labels.length; i++) {
  Logger.log(labels[i].getName());
}

Return

GmailLabel[] – ein Array mit Labels für diesen Thread

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

getLastMessageDate()

Ruft das Datum der neuesten Nachricht dieser Unterhaltung ab.

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

Return

Date: Das Datum der neuesten Nachricht im Thread

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log(firstThread.getMessageCount());

Return

Integer: die Anzahl der Nachrichten im Thread

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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
var firstThread = GmailApp.getInboxThreads(0,1)[0];
var messages = firstThread.getMessages();
for (var i = 0; i < messages.length; i++) {
  Logger.log(messages[i].getSubject());
}

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• getMessageCount()

---

getPermalink()

Ruft einen Permalink für diesen Thread ab.

Hinweis: Dies funktioniert nur in der klassischen Gmail-Oberfläche, nicht in Inbox.

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

Return

String – der Permalink für diesen Thread

---

hasStarredMessages()

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

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

Return

Boolean: „true“, wenn der Thread markierte Nachrichten enthält

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Important? : ' + firstThread.isImportant());

Return

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

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

isInChats()

Gibt zurück, ob der Thread das Label „Chat“ hat.

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

Return

Boolean: „true“, wenn der Thread das Label „Chat“ hat

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('is in the inbox? : ' + firstThread.isInInbox());

Return

Boolean: „true“, wenn sich die Unterhaltung im Posteingang befindet

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

isInPriorityInbox()

Gibt „true“ zurück, wenn sich dieser Thread im sortierten Posteingang befindet. Andernfalls wird „false“ zurückgegeben.

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

Return

Boolean: „true“, wenn sich die Unterhaltung im sortierten Posteingang befindet

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

isInSpam()

Gibt zurück, ob der Thread als Spam markiert wurde.

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

Return

Boolean: Gibt an, ob diese Unterhaltung als Spam markiert wurde.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Trashed? ' + firstThread.isInTrash());

Return

Boolean: „true“, wenn sich die Unterhaltung im Papierkorb befindet

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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
var firstThread = GmailApp.getInboxThreads(0,1)[0];
Logger.log('Unread? ' + firstThread.isUnread());

Return

Boolean: „true“, wenn ungelesene Nachrichten vorhanden sind

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

markImportant()

Kennzeichnet diese Unterhaltung als wichtig.

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markUnimportant()

---

markRead()

Markiert diesen Thread als gelesen.

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markUnread()

---

markUnimportant()

Kennzeichnet diese Konversation als unwichtig.

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markImportant()

---

markUnread()

Diese Unterhaltung wird als ungelesen markiert.

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• markRead()

---

moveToArchive()

Verschiebt diese Unterhaltung in das Archiv.

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

moveToInbox()

Verschiebt diese Konversation in den Posteingang.

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

moveToSpam()

Verschiebt diese Unterhaltung in den Spamordner.

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

moveToTrash()

Verschiebt diese Konversation in den Papierkorb.

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen 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).

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

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

removeLabel(label)

Entfernt dieses Label aus dem Thread.

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

Parameter

Name	Typ	Beschreibung
label	GmailLabel	Das Label, das aus diesem Thread entfernt werden soll

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

• addLabel(label)

---

reply(body)

Dem Absender der letzten Nachricht in dieser Unterhaltung mit der Adresse "responseTo" antworten.

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

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

Parameter

Name	Typ	Beschreibung
body	String	Der E-Mail-Text

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

reply(body, options)

Mit der Adresse "responseTo" antworten Sie dem Absender der letzten Nachricht in diesem Thread mit optionalen Argumenten. Die E-Mail kann sowohl reinen Text als auch HTML-Text enthalten. Die Gesamtgröße der E-Mail (einschließlich aller Header, außer Anhänge) darf 20 KB nicht überschreiten.

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

Parameter

Name	Typ	Beschreibung
body	String	Der E-Mail-Text
options	Object	Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt

Erweiterte Parameter

Name	Typ	Beschreibung
cc	String	eine durch Kommas getrennte Liste von E-Mail-Adressen, die in Cc gesetzt werden sollen
bcc	String	eine durch Kommas getrennte Liste von E-Mail-Adressen, die in Bcc gesetzt werden sollen
htmlBody	String	Ist die Richtlinie festgelegt, verwenden Geräte, die HTML rendern können, dieses Argument anstelle des erforderlichen Textarguments. Wenn du Inline-Bilder für deine E-Mail hast, kannst du ein optionales inlineImages-Feld im HTML-Text hinzufügen.
name	String	den Namen des Absenders der E-Mail (Standard: der Name des Nutzers)
from	String	Die Adresse, von der die E-Mail gesendet werden soll. Diese muss einer der von GmailApp.getAliases() zurückgegebenen Werte sein.
replyTo	String	eine E-Mail-Adresse, die als standardmäßige Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers)
noReply	Boolean	true, wenn die E-Mail von einer generischen E-Mail-Adresse gesendet werden soll, von der keine Antworten gesendet werden können, um Empfänger davon abzuhalten, auf E-Mails zu antworten. Diese Option ist nur für Google Workspace-Konten und nicht für Gmail-Nutzer möglich.
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 Bilddaten (BlobSource) enthält. Dabei wird davon ausgegangen, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält.

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

replyAll(body)

Dem Absender (über die Adresse "responseTo") und allen Empfängern der letzten Nachricht in diesem Thread antworten.

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

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

Parameter

Name	Typ	Beschreibung
body	String	Der E-Mail-Text

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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

---

replyAll(body, options)

Antworten Sie dem Absender (mit der Adresse replyTo) und allen Empfängern der letzten Nachricht in diesem Thread mit optionalen Argumenten. Die E-Mail kann sowohl reinen Text als auch HTML-Text enthalten. Die Gesamtgröße der E-Mail (einschließlich aller Header, ausgenommen Anhänge) darf 20 KB nicht überschreiten.

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

Parameter

Name	Typ	Beschreibung
body	String	Der E-Mail-Text
options	Object	Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt

Erweiterte Parameter

Name	Typ	Beschreibung
cc	String	eine durch Kommas getrennte Liste von E-Mail-Adressen, die in Cc gesetzt werden sollen
bcc	String	eine durch Kommas getrennte Liste von E-Mail-Adressen, die in Bcc gesetzt werden sollen
htmlBody	String	Ist die Richtlinie festgelegt, verwenden Geräte, die HTML rendern können, dieses Argument anstelle des erforderlichen Textarguments. Wenn du Inline-Bilder für deine E-Mail hast, kannst du ein optionales inlineImages-Feld im HTML-Text hinzufügen.
name	String	den Namen des Absenders der E-Mail (Standard: der Name des Nutzers)
from	String	Die Adresse, von der die E-Mail gesendet werden soll. Diese muss einer der von GmailApp.getAliases() zurückgegebenen Werte sein.
replyTo	String	eine E-Mail-Adresse, die als standardmäßige Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers)
noReply	Boolean	true, wenn die E-Mail von einer generischen E-Mail-Adresse gesendet werden soll, von der keine Antworten gesendet werden können, um Empfänger daran zu hindern, auf E-Mails zu antworten. Diese Option ist nur für G Suite-Konten und nicht für Gmail-Nutzer möglich.
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 Bilddaten (BlobSource) enthält. Dabei wird davon ausgegangen, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält.

Return

GmailThread – dieser Thread, nützlich für Verkettungen

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

Weitere Informationen

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