Eine Nachricht im Gmail-Konto eines Nutzers.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
createDraftReply(body) | GmailDraft | Erstellt einen Nachrichtenentwurf, der dem Absender dieser Nachricht mithilfe der Antwortadresse antwortet. |
createDraftReply(body, options) | GmailDraft | Erstellt einen Nachrichtenentwurf, der dem Absender dieser Nachricht unter Verwendung der Antwortadresse antwortet, mit optionale Argumente. |
createDraftReplyAll(body) | GmailDraft | Erstellt einen Nachrichtenentwurf, der dem Absender unter Verwendung der Antwortadresse und aller Empfänger von diese Nachricht. |
createDraftReplyAll(body, options) | GmailDraft | Erstellt einen Nachrichtenentwurf, der dem Absender dieser Nachricht unter Verwendung der Antwortadresse und Alle Empfänger mit optionalen Argumenten. |
forward(recipient) | GmailMessage | Leitet diese Nachricht an die neuen Empfänger weiter. |
forward(recipient, options) | GmailMessage | Leitet diese Nachricht mit optionalen Argumenten an neue Empfänger weiter. |
getAttachments() | GmailAttachment[] | Ruft alle Anhänge für diese Nachricht ab. |
getAttachments(options) | GmailAttachment[] | Ruft alle Anhänge für diese Nachricht ab. |
getBcc() | String | Ruft die durch Kommas getrennten Empfänger für diese Nachricht auf Bcc ab. |
getBody() | String | Ruft den HTML-Inhalt des Nachrichtentexts ab. |
getCc() | String | Ruft die durch Kommas getrennten Empfänger für diese Nachricht auf CC ab. |
getDate() | Date | Ruft Datum und Uhrzeit der Nachricht ab. |
getFrom() | String | Ruft den Absender der Nachricht ab. |
getHeader(name) | String | Ruft den Wert eines RFC 2822-Headers anhand des Headernamens ab. |
getId() | String | Ruft die ID der Nachricht ab. |
getPlainBody() | String | Ruft den Inhalt des Nachrichtentexts ohne HTML-Formatierung ab. |
getRawContent() | String | Ruft den Rohinhalt der Nachricht ab. |
getReplyTo() | String | Ruft die Antwortadresse der Nachricht ab (normalerweise der Absender). |
getSubject() | String | Ruft den Betreff der Nachricht ab. |
getThread() | GmailThread | Ruft den Thread ab, der diese Nachricht enthält. |
getTo() | String | Ruft die durch Kommas getrennten Empfänger der Nachricht ab. |
isDraft() | Boolean | Ruft ab, ob diese Nachricht ein Entwurf ist. |
isInChats() | Boolean | Ruft ab, ob diese Nachricht ein Chat ist. |
isInInbox() | Boolean | Ruft ab, ob sich diese Nachricht im Posteingang befindet. |
isInPriorityInbox() | Boolean | Gibt true zurück, wenn sich die Nachricht im sortierten Eingang befindet. Andernfalls wird false zurückgegeben. |
isInTrash() | Boolean | Ruft ab, ob sich die Nachricht im Papierkorb befindet. |
isStarred() | Boolean | Ruft ab, ob diese Nachricht markiert ist. |
isUnread() | Boolean | Ruft ab, ob diese Nachricht ungelesen ist. |
markRead() | GmailMessage | Die Nachricht wird als gelesen markiert. |
markUnread() | GmailMessage | Die Nachricht wird als ungelesen markiert. |
moveToTrash() | GmailMessage | Die Nachricht wird in den Papierkorb verschoben. |
refresh() | GmailMessage | Lädt diese Nachricht und den zugehörigen Status aus Gmail neu (nützlich für den Fall, dass Labels, Lesestatus, sich geändert haben). |
reply(body) | GmailMessage | Dem Absender dieser Nachricht über die Antwortadresse antworten |
reply(body, options) | GmailMessage | Dem Absender dieser Nachricht über die Antwortadresse mit optionalen Argumenten antworten. |
replyAll(body) | GmailMessage | Der Absender antwortet über die Antwortadresse und alle Empfänger dieser Nachricht. |
replyAll(body, options) | GmailMessage | Dem Absender dieser Nachricht über die Antwortadresse und alle Empfänger antworten, mit optionale Argumente. |
star() | GmailMessage | Die Nachricht wird mit einem Stern markiert. |
unstar() | GmailMessage | Hebt die Markierung der Nachricht auf. |
Detaillierte Dokumentation
createDraftReply(body)
Erstellt einen Nachrichtenentwurf, der dem Absender dieser Nachricht mithilfe der Antwortadresse antwortet. Die Die Größe der E-Mail (einschließlich Header) ist das Kontingent begrenzt.
// Create a draft reply to the original message with an acknowledgment. var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.createDraftReply("Got your message");
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Der Text der E-Mail. |
Rückflug
GmailDraft
: Der neu erstellte Nachrichtenentwurf.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
createDraftReply(body, options)
Erstellt einen Nachrichtenentwurf, der dem Absender dieser Nachricht unter Verwendung der Antwortadresse antwortet, mit optionale Argumente.
Die E-Mail kann sowohl Text als auch HTML-Text enthalten. Die Größe der E-Mail (einschließlich -Header) ist das Kontingent eingeschränkt.
// Create a draft response with an HTML text body. var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.createDraftReply("incapable of HTML", { htmlBody: "<b>some HTML body text</b>", cc: "[email protected]" });
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Der Text der E-Mail. |
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | BlobSource[] | eine Array der 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 für das Cc-Feld |
from | String | Adresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine
der von GmailApp.getAliases() zurückgegebenen Werte |
htmlBody | String | Wenn dies festgelegt ist, wird HTML-Code auf Geräten, die HTML rendern können, anstelle von
das erforderliche Argument body; können Sie ein optionales inlineImages -Feld im HTML-Textkörper
wenn Sie Inline-Bilder für Ihre E-Mails |
inlineImages | Object | JavaScript-Objekt, das eine Zuordnung vom Image-Schlüssel enthält
(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" /> enthalten sind. |
name | String | Der Name des Absenders der E-Mail (Standard: der Name des Nutzers) |
replyTo | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail mit bis zu 250 Zeichen. |
Rückflug
GmailDraft
: Der neu erstellte Nachrichtenentwurf.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
createDraftReplyAll(body)
Erstellt einen Nachrichtenentwurf, der dem Absender unter Verwendung der Antwortadresse und aller Empfänger von diese Nachricht. Die Größe der E-Mail (einschließlich Header) ist kontingent begrenzt.
// Create a draft response to all recipients (except those bcc'd) with an acknowledgment. var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.createDraftReplyAll("Got your message");
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Der Text der E-Mail. |
Rückflug
GmailDraft
: Der neu erstellte Nachrichtenentwurf.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
createDraftReplyAll(body, options)
Erstellt einen Nachrichtenentwurf, der dem Absender dieser Nachricht unter Verwendung der Antwortadresse und Alle Empfänger mit optionalen Argumenten.
Die E-Mail kann sowohl Text als auch HTML-Text enthalten. Die Größe der E-Mail (einschließlich -Header) ist das Kontingent eingeschränkt.
// Create a draft response to all recipients (except those bcc'd) using an HTML text body. var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.createDraftReplyAll("incapable of HTML", { htmlBody: "<b>some HTML body text</b>", cc: "[email protected]" });
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Der Text der E-Mail. |
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | BlobSource[] | eine Array der 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 für das Cc-Feld |
from | String | Adresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine
der von GmailApp.getAliases() zurückgegebenen Werte |
htmlBody | String | Wenn dies festgelegt ist, wird HTML-Code auf Geräten, die HTML rendern können, anstelle von
das erforderliche Argument body; können Sie ein optionales inlineImages -Feld im HTML-Textkörper
wenn Sie Inline-Bilder für Ihre E-Mails |
inlineImages | Object | JavaScript-Objekt, das eine Zuordnung vom Image-Schlüssel enthält
(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" /> enthalten sind. |
name | String | Der Name des Absenders der E-Mail (Standard: der Name des Nutzers) |
replyTo | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail mit bis zu 250 Zeichen. |
Rückflug
GmailDraft
: Der neu erstellte Nachrichtenentwurf.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
forward(recipient)
Leitet diese Nachricht an die neuen Empfänger weiter. Die Größe der E-Mail (einschließlich Header) ist kontingent begrenzt.
// Forward first message of first inbox thread to recipient1 & recipient2, both @example.com var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.forward("[email protected],[email protected]");
Parameter
Name | Typ | Beschreibung |
---|---|---|
recipient | String | Eine durch Kommas getrennte Liste von E-Mail-Adressen. |
Rückflug
GmailMessage
: Diese Nachricht ist nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
forward(recipient, options)
Leitet diese Nachricht mit optionalen Argumenten an neue Empfänger weiter.
Die E-Mail kann sowohl Text als auch HTML-Text enthalten. Die Größe der E-Mail (einschließlich Header) ist Kontingent eingeschränkt.
var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.forward("[email protected],[email protected]", { cc: "[email protected]", bcc: "[email protected],[email protected]" });
Parameter
Name | Typ | Beschreibung |
---|---|---|
recipient | String | Eine durch Kommas getrennte Liste von E-Mail-Adressen. |
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | BlobSource[] | eine Array der 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 für das Cc-Feld |
from | String | Adresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine
der von GmailApp.getAliases() zurückgegebenen Werte |
htmlBody | String | Wenn dies festgelegt ist, wird HTML-Code auf Geräten, die HTML rendern können, anstelle von
das erforderliche Argument body; können Sie ein optionales inlineImages -Feld im HTML-Textkörper
wenn Sie Inline-Bilder für Ihre E-Mails |
inlineImages | Object | JavaScript-Objekt, das eine Zuordnung vom Image-Schlüssel enthält
(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" /> enthalten sind. |
name | String | Der Name des Absenders der E-Mail (Standard: der Name des Nutzers) |
noReply | Boolean | true , wenn die E-Mail von einer allgemeinen E-Mail-Adresse gesendet werden soll
Antwort-E-Mail-Adresse, um Empfänger davon abzuhalten, auf E-Mails zu antworten ist diese Option
nur für Google Workspace-Konten möglich, nicht für Gmail-Nutzer |
replyTo | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail mit bis zu 250 Zeichen. |
Rückflug
GmailMessage
: Diese Nachricht ist nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
getAttachments()
Ruft alle Anhänge für diese Nachricht ab.
Rückflug
GmailAttachment[]
: Ein Array von Blob-Anhängen für diese Nachricht.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
getAttachments(options)
Ruft alle Anhänge für diese Nachricht ab.
Parameter
Name | Typ | Beschreibung |
---|---|---|
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
includeInlineImages | Boolean | true , wenn das zurückgegebene Array von Blob
Anhänge sollten Inline-Bilder enthalten (Standardeinstellung ist true ). |
includeAttachments | Boolean | true , wenn das zurückgegebene Array von Blob
Anhänge sollten normale Anhänge (nicht inline) enthalten (Standard ist true ). |
Rückflug
GmailAttachment[]
: Ein Array von Blob-Anhängen für diese Nachricht.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
getBcc()
Ruft die durch Kommas getrennten Empfänger für diese Nachricht auf Bcc ab.
Dieses Feld ist für alle empfangenen Nachrichten standardmäßig leer.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getBcc()); // Log bcc'd addresses
Rückflug
String
: Die kommagetrennten Empfänger dieser Nachricht auf Bcc.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
getBody()
Ruft den HTML-Inhalt des Nachrichtentexts ab.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getBody()); // Log contents of the body
Rückflug
String
: Der Textinhalt der Nachricht.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
getCc()
Ruft die durch Kommas getrennten Empfänger für diese Nachricht auf CC ab.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getCc()); // Log cc'd addresses
Rückflug
String
: Die durch Kommas getrennten Empfänger für diese Nachricht auf Cc.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
getDate()
Ruft Datum und Uhrzeit der Nachricht ab.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getDate()); // Log date and time of the message
Rückflug
Date
: Datum und Uhrzeit der Nachricht.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
getFrom()
Ruft den Absender der Nachricht ab.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getFrom()); // Log from address of the message
Rückflug
String
: Die E-Mail-Adresse des Absenders der Nachricht.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
getHeader(name)
Ruft den Wert eines RFC 2822-Headers anhand des Headernamens ab.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox. var message = thread.getMessages()[0]; // Get the first message. Logger.log(message.getHeader("Message-ID")); // Logs the Message-ID RFC 2822 header.
Parameter
Name | Typ | Beschreibung |
---|---|---|
name | String | Der Name des RFC-Headers ohne Doppelpunkt, der ihn vom Wert trennt. |
Rückflug
String
: Der Wert des Headers oder ein leerer String, wenn der Header nicht in der Nachricht vorhanden ist.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
getId()
Ruft die ID der Nachricht ab.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message var id = message.getId(); var messageById = GmailApp.getMessageById(id); Logger.log(message.getSubject() == messageById.getMessage()); // Always logs true
Rückflug
String
: Die Nachrichten-ID.
getPlainBody()
Ruft den Inhalt des Nachrichtentexts ohne HTML-Formatierung ab. Das ist komplexer als
getBody()
und dauert länger.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getPlainBody()); // Log contents of the body
Rückflug
String
: Der reine Nachrichteninhalt.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
getRawContent()
Ruft den Rohinhalt der Nachricht ab. Dies entspricht „Original anzeigen“ in der Benutzeroberfläche von Gmail.
Rückflug
String
: Der Rohinhalt der Nachricht.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
getReplyTo()
Ruft die Antwortadresse der Nachricht ab (normalerweise der Absender).
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getReplyTo()); // Logs reply-to address
Rückflug
String
: Die E-Mail-Adresse für Antworten.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
getSubject()
Ruft den Betreff der Nachricht ab.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getSubject()); // Log subject line
Rückflug
String
: Der Betreff der Nachricht.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
getThread()
Ruft den Thread ab, der diese Nachricht enthält.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getThread().getFirstMessageSubject() == thread.getFirstMessageSubject()); // Always logs true
Rückflug
GmailThread
: Der GmailThread, der diese Nachricht enthält.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
getTo()
Ruft die durch Kommas getrennten Empfänger der Nachricht ab.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log(message.getTo()); // Log the recipient of message
Rückflug
String
: Die durch Kommas getrennten Empfänger der Nachricht.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
isDraft()
Ruft ab, ob diese Nachricht ein Entwurf ist.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is draft? " + message.isDraft());
Rückflug
Boolean
: Gibt an, ob die Nachricht ein Entwurf ist.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
isInChats()
Ruft ab, ob diese Nachricht ein Chat ist.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is a chat? " + message.isInChats());
Rückflug
Boolean
: Gibt an, ob die Nachricht ein Chat ist.
isInInbox()
Ruft ab, ob sich diese Nachricht im Posteingang befindet.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is in inbox? " + message.isInInbox());
Rückflug
Boolean
: Gibt an, ob sich die Nachricht im Posteingang befindet.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
isInPriorityInbox()
Gibt true
zurück, wenn sich die Nachricht im sortierten Eingang befindet. Andernfalls wird false
zurückgegeben.
var thread = GmailApp.getPriorityInboxThreads(0,1)[0]; // Get first thread in priority inbox var messages = thread.getMessages(); for (var i = 0; i < messages.length; i++) { // At least one of the messages is in priority inbox Logger.log("is in priority inbox? " + messages[i].isInPriorityInbox()); }
Rückflug
Boolean
: Gibt an, ob sich die Nachricht im sortierten Eingang befindet.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
isInTrash()
Ruft ab, ob sich die Nachricht im Papierkorb befindet.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is in the trash? " + message.isInTrash());
Rückflug
Boolean
: Gibt an, ob sich die Nachricht im Papierkorb befindet.
isStarred()
Ruft ab, ob diese Nachricht markiert ist.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is starred? " + message.isStarred());
Rückflug
Boolean
: Gibt an, ob die Nachricht markiert ist.
isUnread()
Ruft ab, ob diese Nachricht ungelesen ist.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message Logger.log("is unread? " + message.isUnread());
Rückflug
Boolean
: Der ungelesen-Status der Nachricht.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
markRead()
Die Nachricht wird als gelesen markiert.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.markRead(); // Mark as read
Rückflug
GmailMessage
: Diese GmailMessage, nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
markUnread()
Die Nachricht wird als ungelesen markiert.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.markUnread(); // Mark as unread
Rückflug
GmailMessage
: Diese GmailMessage, nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
moveToTrash()
Die Nachricht wird in den Papierkorb verschoben.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.moveToTrash(); // Move message to trash
Rückflug
GmailMessage
: Diese GmailMessage, nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
refresh()
Lädt diese Nachricht und den zugehörigen Status aus Gmail neu (nützlich für den Fall, dass Labels, Lesestatus, sich geändert haben).
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message // .. Do bunch of stuff here message.refresh(); // Make sure it's up to date // Do more stuff to message
Rückflug
GmailMessage
: Diese Nachricht für die Verkettung.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
reply(body)
Dem Absender dieser Nachricht über die Antwortadresse antworten Die Größe der E-Mail (einschließlich Header) ist Kontingent eingeschränkt.
// Respond to author of message with acknowledgment var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.reply("Got your message");
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Der Text der E-Mail. |
Rückflug
GmailMessage
: Diese Nachricht ist nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
reply(body, options)
Dem Absender dieser Nachricht über die Antwortadresse mit optionalen Argumenten antworten.
Die E-Mail kann sowohl Text als auch HTML-Text enthalten. Die Größe der E-Mail (einschließlich Header) ist Kontingent eingeschränkt.
// Respond with HTML body text var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.reply("incapable of HTML", { htmlBody: "<b>some HTML body text</b>", noReply: true });
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Der Text der E-Mail. |
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | BlobSource[] | eine Array der 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 für das Cc-Feld |
from | String | Adresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine
der von GmailApp.getAliases() zurückgegebenen Werte |
htmlBody | String | Wenn dies festgelegt ist, wird HTML-Code auf Geräten, die HTML rendern können, anstelle von
das erforderliche Argument body; können Sie ein optionales inlineImages -Feld im HTML-Textkörper
wenn Sie Inline-Bilder für Ihre E-Mails |
inlineImages | Object | JavaScript-Objekt, das eine Zuordnung vom Image-Schlüssel enthält
(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" /> enthalten sind. |
name | String | Der Name des Absenders der E-Mail (Standard: der Name des Nutzers) |
noReply | Boolean | true , wenn die E-Mail von einer allgemeinen E-Mail-Adresse gesendet werden soll
Antwort-E-Mail-Adresse, um Empfänger davon abzuhalten, auf E-Mails zu antworten ist diese Option
nur für Google Workspace-Konten möglich, nicht für Gmail-Nutzer |
replyTo | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail mit bis zu 250 Zeichen. |
Rückflug
GmailMessage
: Diese Nachricht ist nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
replyAll(body)
Der Absender antwortet über die Antwortadresse und alle Empfänger dieser Nachricht. Die Größe der E-Mail (einschließlich Header) ist das Kontingent begrenzt.
// Respond to all recipients (except bcc'd) of last email in thread with acknowledgment var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; message.replyAll("Got your message");
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Der Text der E-Mail. |
Rückflug
GmailMessage
: Diese Nachricht ist für Verkettungen nützlich.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
replyAll(body, options)
Dem Absender dieser Nachricht über die Antwortadresse und alle Empfänger antworten, mit optionale Argumente.
Die E-Mail kann sowohl Text als auch HTML-Text enthalten. Die Größe der E-Mail (einschließlich Header) ist Kontingent eingeschränkt.
// Respond with HTML body text var firstThread = GmailApp.getInboxThreads(0,1)[0]; var message = firstThread.getMessages()[0]; messageThread.replyAll("incapable of HTML", { htmlBody: "<b>some HTML body text</b>", noReply: true });
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Der Text der E-Mail. |
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | BlobSource[] | eine Array der 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 für das Cc-Feld |
from | String | Adresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine
der von GmailApp.getAliases() zurückgegebenen Werte |
htmlBody | String | Wenn dies festgelegt ist, wird HTML-Code auf Geräten, die HTML rendern können, anstelle von
das erforderliche Argument body; können Sie ein optionales inlineImages -Feld im HTML-Textkörper
wenn Sie Inline-Bilder für Ihre E-Mails |
inlineImages | Object | JavaScript-Objekt, das eine Zuordnung vom Image-Schlüssel enthält
(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" /> enthalten sind. |
name | String | Der Name des Absenders der E-Mail (Standard: der Name des Nutzers) |
noReply | Boolean | true , wenn die E-Mail von einer allgemeinen E-Mail-Adresse gesendet werden soll
Antwort-E-Mail-Adresse, um Empfänger davon abzuhalten, auf E-Mails zu antworten ist diese Option
nur für Google Workspace-Konten möglich, nicht für Gmail-Nutzer |
replyTo | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail mit bis zu 250 Zeichen. |
Rückflug
GmailMessage
: Diese Nachricht ist nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
star()
Die Nachricht wird mit einem Stern markiert.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.star(); // Star the message
Rückflug
GmailMessage
: Diese GmailMessage, nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/
Weitere Informationen
unstar()
Hebt die Markierung der Nachricht auf.
var thread = GmailApp.getInboxThreads(0,1)[0]; // Get first thread in inbox var message = thread.getMessages()[0]; // Get first message message.unstar(); // Unstar the message
Rückflug
GmailMessage
: Diese GmailMessage, nützlich für Verkettungen.
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung für einen oder mehrere der folgenden Bereiche oder die entsprechenden Bereiche aus der zugehörigen REST API erforderlich:
-
https://mail.google.com/