Class GmailMessage

GmailMessage

Eine Nachricht im Gmail-Konto eines Nutzers.

Methoden

MethodeRückgabetypKurzbeschreibung
createDraftReply(body)GmailDraftErstellt einen Nachrichtenentwurf, der dem Absender dieser Nachricht mithilfe der Antwortadresse antwortet.
createDraftReply(body, options)GmailDraftErstellt einen Nachrichtenentwurf, der dem Absender dieser Nachricht unter Verwendung der Antwortadresse antwortet, mit optionale Argumente.
createDraftReplyAll(body)GmailDraftErstellt einen Nachrichtenentwurf, der dem Absender unter Verwendung der Antwortadresse und aller Empfänger von diese Nachricht.
createDraftReplyAll(body, options)GmailDraftErstellt einen Nachrichtenentwurf, der dem Absender dieser Nachricht unter Verwendung der Antwortadresse und Alle Empfänger mit optionalen Argumenten.
forward(recipient)GmailMessageLeitet diese Nachricht an die neuen Empfänger weiter.
forward(recipient, options)GmailMessageLeitet 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()StringRuft die durch Kommas getrennten Empfänger für diese Nachricht auf Bcc ab.
getBody()StringRuft den HTML-Inhalt des Nachrichtentexts ab.
getCc()StringRuft die durch Kommas getrennten Empfänger für diese Nachricht auf CC ab.
getDate()DateRuft Datum und Uhrzeit der Nachricht ab.
getFrom()StringRuft den Absender der Nachricht ab.
getHeader(name)StringRuft den Wert eines RFC 2822-Headers anhand des Headernamens ab.
getId()StringRuft die ID der Nachricht ab.
getPlainBody()StringRuft den Inhalt des Nachrichtentexts ohne HTML-Formatierung ab.
getRawContent()StringRuft den Rohinhalt der Nachricht ab.
getReplyTo()StringRuft die Antwortadresse der Nachricht ab (normalerweise der Absender).
getSubject()StringRuft den Betreff der Nachricht ab.
getThread()GmailThreadRuft den Thread ab, der diese Nachricht enthält.
getTo()StringRuft die durch Kommas getrennten Empfänger der Nachricht ab.
isDraft()BooleanRuft ab, ob diese Nachricht ein Entwurf ist.
isInChats()BooleanRuft ab, ob diese Nachricht ein Chat ist.
isInInbox()BooleanRuft ab, ob sich diese Nachricht im Posteingang befindet.
isInPriorityInbox()BooleanGibt true zurück, wenn sich die Nachricht im sortierten Eingang befindet. Andernfalls wird false zurückgegeben.
isInTrash()BooleanRuft ab, ob sich die Nachricht im Papierkorb befindet.
isStarred()BooleanRuft ab, ob diese Nachricht markiert ist.
isUnread()BooleanRuft ab, ob diese Nachricht ungelesen ist.
markRead()GmailMessageDie Nachricht wird als gelesen markiert.
markUnread()GmailMessageDie Nachricht wird als ungelesen markiert.
moveToTrash()GmailMessageDie Nachricht wird in den Papierkorb verschoben.
refresh()GmailMessageLä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)GmailMessageDem Absender dieser Nachricht über die Antwortadresse antworten
reply(body, options)GmailMessageDem Absender dieser Nachricht über die Antwortadresse mit optionalen Argumenten antworten.
replyAll(body)GmailMessageDer Absender antwortet über die Antwortadresse und alle Empfänger dieser Nachricht.
replyAll(body, options)GmailMessageDem Absender dieser Nachricht über die Antwortadresse und alle Empfänger antworten, mit optionale Argumente.
star()GmailMessageDie Nachricht wird mit einem Stern markiert.
unstar()GmailMessageHebt 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

NameTypBeschreibung
bodyStringDer 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

NameTypBeschreibung
bodyStringDer Text der E-Mail.
optionsObjectEin JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt.

Erweiterte Parameter

NameTypBeschreibung
attachmentsBlobSource[]eine Array der Dateien, die mit der E-Mail gesendet werden sollen
bccStringeine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc
ccStringeine durch Kommas getrennte Liste von E-Mail-Adressen für das Cc-Feld
fromStringAdresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine der von GmailApp.getAliases() zurückgegebenen Werte
htmlBodyStringWenn 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
inlineImagesObjectJavaScript-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.
nameStringDer Name des Absenders der E-Mail (Standard: der Name des Nutzers)
replyToStringeine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers)
subjectStringEine 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

NameTypBeschreibung
bodyStringDer 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

NameTypBeschreibung
bodyStringDer Text der E-Mail.
optionsObjectEin JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt.

Erweiterte Parameter

NameTypBeschreibung
attachmentsBlobSource[]eine Array der Dateien, die mit der E-Mail gesendet werden sollen
bccStringeine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc
ccStringeine durch Kommas getrennte Liste von E-Mail-Adressen für das Cc-Feld
fromStringAdresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine der von GmailApp.getAliases() zurückgegebenen Werte
htmlBodyStringWenn 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
inlineImagesObjectJavaScript-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.
nameStringDer Name des Absenders der E-Mail (Standard: der Name des Nutzers)
replyToStringeine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers)
subjectStringEine 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

NameTypBeschreibung
recipientStringEine 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

NameTypBeschreibung
recipientStringEine durch Kommas getrennte Liste von E-Mail-Adressen.
optionsObjectEin JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt.

Erweiterte Parameter

NameTypBeschreibung
attachmentsBlobSource[]eine Array der Dateien, die mit der E-Mail gesendet werden sollen
bccStringeine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc
ccStringeine durch Kommas getrennte Liste von E-Mail-Adressen für das Cc-Feld
fromStringAdresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine der von GmailApp.getAliases() zurückgegebenen Werte
htmlBodyStringWenn 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
inlineImagesObjectJavaScript-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.
nameStringDer Name des Absenders der E-Mail (Standard: der Name des Nutzers)
noReplyBooleantrue, 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
replyToStringeine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers)
subjectStringEine 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

NameTypBeschreibung
optionsObjectEin JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt.

Erweiterte Parameter

NameTypBeschreibung
includeInlineImagesBooleantrue, wenn das zurückgegebene Array von Blob Anhänge sollten Inline-Bilder enthalten (Standardeinstellung ist true).
includeAttachmentsBooleantrue, 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

NameTypBeschreibung
nameStringDer 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

NameTypBeschreibung
bodyStringDer 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

NameTypBeschreibung
bodyStringDer Text der E-Mail.
optionsObjectEin JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt.

Erweiterte Parameter

NameTypBeschreibung
attachmentsBlobSource[]eine Array der Dateien, die mit der E-Mail gesendet werden sollen
bccStringeine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc
ccStringeine durch Kommas getrennte Liste von E-Mail-Adressen für das Cc-Feld
fromStringAdresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine der von GmailApp.getAliases() zurückgegebenen Werte
htmlBodyStringWenn 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
inlineImagesObjectJavaScript-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.
nameStringDer Name des Absenders der E-Mail (Standard: der Name des Nutzers)
noReplyBooleantrue, 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
replyToStringeine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers)
subjectStringEine 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

NameTypBeschreibung
bodyStringDer 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

NameTypBeschreibung
bodyStringDer Text der E-Mail.
optionsObjectEin JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt.

Erweiterte Parameter

NameTypBeschreibung
attachmentsBlobSource[]eine Array der Dateien, die mit der E-Mail gesendet werden sollen
bccStringeine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc
ccStringeine durch Kommas getrennte Liste von E-Mail-Adressen für das Cc-Feld
fromStringAdresse, von der aus die E-Mail gesendet werden soll. Dabei muss es sich um eine der von GmailApp.getAliases() zurückgegebenen Werte
htmlBodyStringWenn 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
inlineImagesObjectJavaScript-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.
nameStringDer Name des Absenders der E-Mail (Standard: der Name des Nutzers)
noReplyBooleantrue, 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
replyToStringeine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: E-Mail-Adresse des Nutzers)
subjectStringEine 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/

Weitere Informationen