Class GmailThread

Gmail-Thread

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 Entwurf einer Nachricht, in der der Absender der letzten Nachricht in diesem Thread mit der Antwortadresse antwortet wird.
createDraftReply(body, options)	GmailDraft	Erstellt einen Entwurf einer Nachricht, die an den Absender der letzten Nachricht in diesem Thread mit der Rücksendeadresse und optionalen Argumenten geantwortet wird.
createDraftReplyAll(body)	GmailDraft	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.
createDraftReplyAll(body, options)	GmailDraft	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.
getFirstMessageSubject()	String	Der Betreff der ersten Nachricht im Thread.
getId()	String	Ruft die ID dieses Threads ab.
getLabels()	GmailLabel[]	Die von Nutzern erstellten Labels in diesem Thread.
getLastMessageDate()	Date	Das Datum der letzten Nachricht in diesem Thread.
getMessageCount()	Integer	Gibt die Anzahl der Nachrichten im Thread zurück.
getMessages()	GmailMessage[]	Ruft die Nachrichten in diesem Thread ab.
getPermalink()	String	Ruft einen Link zu diesem 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 als Chat gekennzeichnet ist.
isInInbox()	Boolean	Gibt zurück, ob sich der Thread im Posteingang befindet.
isInPriorityInbox()	Boolean	Gibt „wahr“ zurück, wenn sich dieser Thread im Posteingang mit Priorität befindet, andernfalls „falsch“.
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 an, 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	Dieser Thread wird als unwichtig markiert.
markUnread()	GmailThread	Dieser Thread wird als ungelesen markiert.
moveToArchive()	GmailThread	Verschiebt diesen Thread ins Archiv.
moveToInbox()	GmailThread	Verschiebt diesen Thread in den Posteingang.
moveToSpam()	GmailThread	Dieser Thread wird in den Spamordner verschoben.
moveToTrash()	GmailThread	Dieser Thread wird in den Papierkorb verschoben.
refresh()	GmailThread	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.
removeLabel(label)	GmailThread	Dadurch wird das Label aus der Konversation entfernt.
reply(body)	GmailThread	Antworten Sie dem Absender der letzten Nachricht in diesem Thread mit der replyTo-Adresse.
reply(body, options)	GmailThread	Sie antworten dem Absender der letzten Nachricht in diesem Thread mit der replyTo-Adresse und optionalen Argumenten.
replyAll(body)	GmailThread	Antworten Sie an den Absender (mit der replyTo-Adresse) und an alle Empfänger der letzten Nachricht in diesem Thread.
replyAll(body, options)	GmailThread	Antworten Sie mit optionalen Argumenten an den Absender (mit der replyTo-Adresse) und alle Empfänger der letzten Nachricht in diesem Thread.

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, 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)

---

createDraftReply(body)

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

Name	Typ	Beschreibung
body	String	im Textkörper der E-Mail

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)

---

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

Parameter

Name	Typ	Beschreibung
body	String	im Textkörper der E-Mail
options	Object	ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt

Erweiterte Parameter

Name	Typ	Beschreibung
attachments	BlobSource[]	eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen
bcc	String	eine durch Kommas getrennte Liste der E-Mail-Adressen für die BCC-Funktion
cc	String	eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf 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 festgelegt, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inlineImages-Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben.
inlineImages	Object	ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (String) zu Bilddaten (BlobSource); 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: 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 (maximal 250 Zeichen)

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)

---

createDraftReplyAll(body)

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

Name	Typ	Beschreibung
body	String	im Textkörper der E-Mail

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)

---

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

Parameter

Name	Typ	Beschreibung
body	String	im Textkörper der E-Mail
options	Object	ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt

Erweiterte Parameter

Name	Typ	Beschreibung
attachments	BlobSource[]	eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen
bcc	String	eine durch Kommas getrennte Liste der E-Mail-Adressen für die BCC-Funktion
cc	String	eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf 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 festgelegt, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inlineImages-Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben.
inlineImages	Object	ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (String) zu Bilddaten (BlobSource); 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: 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. Die maximale Größe beträgt 250 Zeichen.

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)

---

getFirstMessageSubject()

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

---

getId()

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

---

getLabels()

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/

---

getLastMessageDate()

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

---

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

---

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

---

getPermalink()

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

---

hasStarredMessages()

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/

---

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, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen 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 – „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/

---

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

---

isInPriorityInbox()

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/

---

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

---

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

---

isUnread()

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/

---

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

---

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

---

markUnimportant()

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

---

markUnread()

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

---

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, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen 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, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:

• https://mail.google.com/

---

moveToSpam()

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/

---

moveToTrash()

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/

---

refresh()

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/

---

removeLabel(label)

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

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

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)

---

reply(body)

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

Name	Typ	Beschreibung
body	String	im Textkörper der E-Mail

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)

---

reply(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

Name	Typ	Beschreibung
body	String	im Textkörper der E-Mail
options	Object	ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt

Erweiterte Parameter

Name	Typ	Beschreibung
cc	String	Eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf Cc gesetzt werden sollen
bcc	String	eine kommagetrennte Liste mit E-Mail-Adressen für die BCC-Funktion
htmlBody	String	Wenn festgelegt, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inlineImages-Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben.
name	String	den Namen des Absenders der E-Mail (Standard: 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 generischen E-Mail-Adresse ohne Antwortfunktion 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[]	eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen
inlineImages	Object	ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (String) zu Bilddaten (BlobSource); dabei wird davon ausgegangen, 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, 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)

---

replyAll(body)

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

Name	Typ	Beschreibung
body	String	im Textkörper der E-Mail

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)

---

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

Name	Typ	Beschreibung
body	String	im Textkörper der E-Mail
options	Object	ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt

Erweiterte Parameter

Name	Typ	Beschreibung
cc	String	Eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf Cc gesetzt werden sollen
bcc	String	eine kommagetrennte Liste mit E-Mail-Adressen für die BCC-Funktion
htmlBody	String	Wenn festgelegt, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inlineImages-Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben.
name	String	den Namen des Absenders der E-Mail (Standard: 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, ob die E-Mail von einer generischen E-Mail-Adresse ohne Antwortfunktion gesendet werden soll, um Empfänger davon abzuhalten, auf E-Mails zu antworten. Diese Option ist nur für G Suite-Konten und nicht für Gmail-Nutzer verfügbar.
attachments	BlobSource[]	eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen
inlineImages	Object	ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (String) zu Bilddaten (BlobSource); dabei wird davon ausgegangen, 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, 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)