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
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
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: "another@example.com" });
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
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
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: "another@example.com" });
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
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
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
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()
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
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
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
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
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
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
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)
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
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
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/