Class GmailMessage

GmailMessage

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

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

---

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

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

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

---

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

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

---

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

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

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

---

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("[e-mail],[e-mail]");

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)

---

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("[e-mail],[e-mail]", {
  cc: "[e-mail]",
  bcc: "[e-mail],[e-mail]"
});

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

• forward(recipient)

---

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

• getTo()

---

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

• getSubject()

---

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

• getTo()

---

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

• getReplyTo()

---

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

• getSubject()

---

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

• getCc()

---

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

• getAttachments()

---

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

• getCc()

---

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

• isUnread()

---

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

• isUnread()

---

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

• isInTrash()

---

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)
• replyAll(body)
• replyAll(body, options)

---

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

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

---

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

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

---

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

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

---

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

---

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/

Weitere Informationen

• star()