Eine Nachricht im Gmail-Konto eines Nutzers.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
create | Gmail | Erstellt einen Nachrichtenentwurf, in dem der Absender dieser Nachricht über die Adresse „An“ beantwortet wird. |
create | Gmail | Erstellt einen Entwurf einer Antwortnachricht, die an den Absender dieser Nachricht mit der Rücksendeadresse gesendet wird. Optionale Argumente sind zulässig. |
create | Gmail | Erstellt einen Entwurf einer Antwort an den Absender mit der Antwortadresse und allen Empfängern dieser Nachricht. |
create | Gmail | Erstellt einen Entwurf einer Antwortnachricht an den Absender dieser Nachricht mit der Rücksendeadresse und allen Empfängern mit optionalen Argumenten. |
forward(recipient) | Gmail | Diese Nachricht wird an neue Empfänger weitergeleitet. |
forward(recipient, options) | Gmail | Diese Nachricht wird mit optionalen Argumenten an neue Empfänger weitergeleitet. |
get | Gmail | Ruft alle Anhänge für diese Nachricht ab. |
get | Gmail | Ruft alle Anhänge für diese Nachricht ab. |
get | String | Die durch Kommas getrennten Empfänger, die in dieser Nachricht eine Bcc-Adresse haben. |
get | String | Ruft den HTML-Inhalt des Textkörpers dieser Nachricht ab. |
get | String | Die Empfänger, die in dieser Nachricht auf Kopie gesetzt wurden, werden durch Kommas getrennt. |
get | Date | Ruft das Datum und die Uhrzeit dieser Nachricht ab. |
get | String | Ruft den Absender der Nachricht ab. |
get | String | Ruft den Wert eines RFC 2822-Headers anhand des Headernamens ab. |
get | String | Ruft die ID dieser Nachricht ab. |
get | String | Ruft den Inhalt des Textkörpers dieser Nachricht ohne HTML-Formatierung ab. |
get | String | Ruft den Rohinhalt dieser Nachricht ab. |
get | String | Die Antwortadresse dieser Nachricht wird abgerufen (normalerweise die des Absenders). |
get | String | Ruft den Betreff der Nachricht ab. |
get | Gmail | Ruft den Thread ab, der diese Nachricht enthält. |
get | String | Die Empfänger dieser Nachricht, getrennt durch Kommas. |
is | Boolean | Gibt an, ob es sich bei dieser Nachricht um einen Entwurf handelt. |
is | Boolean | Gibt an, ob es sich bei dieser Nachricht um einen Chat handelt. |
is | Boolean | Gibt an, ob sich diese Nachricht im Posteingang befindet. |
is | Boolean | Gibt true zurück, wenn sich diese Nachricht im Posteingang mit Priorität befindet. Andernfalls wird false zurückgegeben. |
is | Boolean | Gibt an, ob sich diese Nachricht im Papierkorb befindet. |
is | Boolean | Gibt an, ob diese Nachricht mit einem Stern markiert ist. |
is | Boolean | Gibt an, ob diese Nachricht ungelesen ist. |
mark | Gmail | Die Nachricht wird als gelesen markiert. |
mark | Gmail | Die Nachricht wird als ungelesen markiert. |
move | Gmail | Die Nachricht wird in den Papierkorb verschoben. |
refresh() | Gmail | Diese Nachricht und der zugehörige Status werden aus Gmail neu geladen. Das ist nützlich, wenn sich beispielsweise die Labels oder der Lesestatus geändert haben. |
reply(body) | Gmail | Hiermit wird der Absender dieser Nachricht über die Antwortadresse kontaktiert. |
reply(body, options) | Gmail | Hiermit wird an den Absender dieser Nachricht mit der Antwortadresse geantwortet. Optionale Argumente sind zulässig. |
reply | Gmail | Antworten an den Absender über die Adresse „An:“ und an alle Empfänger dieser Nachricht. |
reply | Gmail | Hiermit antworten Sie dem Absender dieser Nachricht über die Adresse „An“ und alle Empfänger mit optionalen Argumenten. |
star() | Gmail | Die Nachricht wird mit einem Stern markiert. |
unstar() | Gmail | Die Markierung für die Nachricht wird aufgehoben. |
Detaillierte Dokumentation
create Draft Reply(body)
Erstellt einen Nachrichtenentwurf, in dem der Absender dieser Nachricht über die Adresse „An“ beantwortet wird. Die Größe der E-Mail (einschließlich Header) ist kontingentiert.
// Create a draft reply to the original message with an acknowledgment. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.createDraftReply('Got your message');
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Den Text der E-Mail. |
Rückflug
Gmail
: Die neu erstellte Entwurfsnachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
create Draft Reply(body, options)
Erstellt einen Entwurf einer Antwortnachricht, die an den Absender dieser Nachricht mit der Rücksendeadresse gesendet wird. Optionale Argumente sind zulässig.
Die E-Mail kann sowohl Nur-Text als auch einen HTML-Textkörper enthalten. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.
// Create a draft response with an HTML text body. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.createDraftReply('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', cc: 'another@example.com', });
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Den Text der E-Mail. |
options | Object | Ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | Blob | eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen |
bcc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen für die BCC-Funktion |
cc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf Cc gesetzt werden sollen |
from | String | Die Adresse, von der die E-Mail gesendet werden soll. Sie muss einer der von Gmail zurückgegebenen Werte sein. |
html | String | Wenn dieses Attribut festgelegt ist, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inline -Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben. |
inline | Object | ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (String ) zu Bilddaten (Blob ); dabei wird davon ausgegangen, dass der Parameter html verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält |
name | String | den Namen des Absenders der E-Mail (Standard: Name des Nutzers) |
reply | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail, maximal 250 Zeichen. |
Rückflug
Gmail
: Die neu erstellte Entwurfsnachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
create Draft Reply All(body)
Erstellt einen Entwurf einer Antwort an den Absender mit der Antwortadresse und allen Empfängern dieser Nachricht. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.
// Create a draft response to all recipients (except those bcc'd) with an // acknowledgment. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.createDraftReplyAll('Got your message');
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Den Text der E-Mail. |
Rückflug
Gmail
: Die neu erstellte Entwurfsnachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
create Draft Reply All(body, options)
Erstellt einen Entwurf einer Antwortnachricht an den Absender dieser Nachricht mit der Rücksendeadresse und allen Empfängern mit optionalen Argumenten.
Die E-Mail kann sowohl Nur-Text als auch einen HTML-Textkörper enthalten. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.
// Create a draft response to all recipients (except those bcc'd) using an HTML // text body. const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.createDraftReplyAll('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', cc: 'another@example.com', });
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Den Text der E-Mail. |
options | Object | Ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | Blob | eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen |
bcc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen für die BCC-Funktion |
cc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf Cc gesetzt werden sollen |
from | String | Die Adresse, von der die E-Mail gesendet werden soll. Sie muss einer der von Gmail zurückgegebenen Werte sein. |
html | String | Wenn dieses Attribut festgelegt ist, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inline -Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben. |
inline | Object | ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (String ) zu Bilddaten (Blob ); dabei wird davon ausgegangen, dass der Parameter html verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält |
name | String | den Namen des Absenders der E-Mail (Standard: Name des Nutzers) |
reply | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail, maximal 250 Zeichen. |
Rückflug
Gmail
: Die neu erstellte Entwurfsnachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
forward(recipient)
Diese Nachricht wird an neue Empfänger weitergeleitet. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.
// Forward first message of first inbox thread to recipient1 & recipient2, // both @example.com const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.forward('recipient1@example.com,recipient2@example.com');
Parameter
Name | Typ | Beschreibung |
---|---|---|
recipient | String | Eine durch Kommas getrennte Liste von E-Mail-Adressen. |
Rückflug
Gmail
– Diese Nachricht ist für die Verkettung nützlich.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
forward(recipient, options)
Diese Nachricht wird mit optionalen Argumenten an neue Empfänger weitergeleitet.
Die E-Mail kann sowohl Nur-Text als auch einen HTML-Textkörper enthalten. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.
const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.forward('recipient1@example.com,recipient2@example.com', { cc: 'myboss@example.com', bcc: 'mybosses-boss@example.com,vp@example.com', });
Parameter
Name | Typ | Beschreibung |
---|---|---|
recipient | String | Eine durch Kommas getrennte Liste von E-Mail-Adressen. |
options | Object | Ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | Blob | eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen |
bcc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen für die BCC-Funktion |
cc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf Cc gesetzt werden sollen |
from | String | Die Adresse, von der die E-Mail gesendet werden soll. Sie muss einer der von Gmail zurückgegebenen Werte sein. |
html | String | Wenn dieses Attribut festgelegt ist, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inline -Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben. |
inline | Object | ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (String ) zu Bilddaten (Blob ); dabei wird davon ausgegangen, dass der Parameter html verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält |
name | String | den Namen des Absenders der E-Mail (Standard: Name des Nutzers) |
no | Boolean | true , wenn die E-Mail von einer generischen E-Mail-Adresse ohne Antwortfunktion gesendet werden soll, um Empfänger davon abzuhalten, auf E-Mails zu antworten. Diese Option ist nur für Google Workspace-Konten verfügbar, nicht für Gmail-Nutzer. |
reply | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail, maximal 250 Zeichen. |
Rückflug
Gmail
– Diese Nachricht ist für die Verkettung nützlich.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
get Attachments()
Ruft alle Anhänge für diese Nachricht ab.
Rückflug
Gmail
: Ein Array von Blob-Anhängen für diese Nachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
get Attachments(options)
Ruft alle Anhänge für diese Nachricht ab.
Parameter
Name | Typ | Beschreibung |
---|---|---|
options | Object | Ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
include | Boolean | true , wenn das zurückgegebene Array von Blob-Anhängen Inline-Bilder enthalten soll (Standard ist true ). |
include | Boolean | true , wenn das zurückgegebene Array von Blob-Anhängen reguläre (nicht Inline-)Anhänge enthalten soll (Standard ist true ). |
Rückflug
Gmail
: Ein Array von Blob-Anhängen für diese Nachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
get Bcc()
Die durch Kommas getrennten Empfänger, die in dieser Nachricht eine Bcc-Adresse haben.
Dieses Feld ist für alle empfangenen Nachrichten definitionsgemäß leer.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getBcc()); // Log bcc'd addresses
Rückflug
String
: Die durch Kommas getrennten Empfänger, die in dieser Nachricht eine Blindkopie erhalten.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
get Body()
Ruft den HTML-Inhalt des Textkörpers dieser Nachricht ab.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getBody()); // Log contents of the body
Rückflug
String
: Der Textkörper dieser Nachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
get Cc()
Die Empfänger, die in dieser Nachricht auf Kopie gesetzt wurden, werden durch Kommas getrennt.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getCc()); // Log cc'd addresses
Rückflug
String
: Die durch Kommas getrennten Empfänger, die in dieser Nachricht auf Kopie gesetzt wurden.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
get Date()
Ruft das Datum und die Uhrzeit dieser Nachricht ab.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getDate()); // Log date and time of the message
Rückflug
Date
– das Datum und die Uhrzeit dieser Nachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
get From()
Ruft den Absender der Nachricht ab.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const 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
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
get Header(name)
Ruft den Wert eines RFC 2822-Headers anhand des Headernamens ab.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox. const 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 den Doppelpunkt, der ihn vom Wert trennt. |
Rückflug
String
: Der Wert des Headers oder ein leerer String, wenn der Header in der Nachricht nicht vorhanden ist.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
get Id()
Ruft die ID dieser Nachricht ab.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message const id = message.getId(); const messageById = GmailApp.getMessageById(id); Logger.log( message.getSubject() === messageById.getMessage()); // Always logs true
Rückflug
String
: Die Nachrichten-ID.
get Plain Body()
Ruft den Inhalt des Textkörpers dieser Nachricht ohne HTML-Formatierung ab. Das ist komplizierter als get
und dauert länger.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getPlainBody()); // Log contents of the body
Rückflug
String
: Der unformatierte Textkörper dieser Nachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
get Raw Content()
Ruft den Rohinhalt dieser Nachricht ab. Dies entspricht der Option „Original anzeigen“ in der Gmail-Benutzeroberfläche.
Rückflug
String
: Der Rohinhalt dieser Nachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
get Reply To()
Die Antwortadresse dieser Nachricht wird abgerufen (normalerweise die des Absenders).
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const 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
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
get Subject()
Ruft den Betreff der Nachricht ab.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getSubject()); // Log subject line
Rückflug
String
: Der Betreff der Nachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
get Thread()
Ruft den Thread ab, der diese Nachricht enthält.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log( message.getThread().getFirstMessageSubject() === thread.getFirstMessageSubject(), ); // Always logs true
Rückflug
Gmail
: Der Gmail-Thread, der diese Nachricht enthält.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
get To()
Die Empfänger dieser Nachricht, getrennt durch Kommas.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(message.getTo()); // Log the recipient of message
Rückflug
String
: Die kommagetrennten Empfänger dieser Nachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
is Draft()
Gibt an, ob es sich bei dieser Nachricht um einen Entwurf handelt.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is draft? ${message.isDraft()}`);
Rückflug
Boolean
: Gibt an, ob es sich bei dieser Nachricht um einen Entwurf handelt.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
is In Chats()
Gibt an, ob es sich bei dieser Nachricht um einen Chat handelt.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is a chat? ${message.isInChats()}`);
Rückflug
Boolean
: Gibt an, ob es sich bei dieser Nachricht um einen Chat handelt.
is In Inbox()
Gibt an, ob sich diese Nachricht im Posteingang befindet.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is in inbox? ${message.isInInbox()}`);
Rückflug
Boolean
: Gibt an, ob sich diese Nachricht im Posteingang befindet.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
is In Priority Inbox()
Gibt true
zurück, wenn sich diese Nachricht im Posteingang mit Priorität befindet. Andernfalls wird false
zurückgegeben.
const thread = GmailApp.getPriorityInboxThreads( 0, 1)[0]; // Get first thread in priority inbox const messages = thread.getMessages(); for (let 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 diese Nachricht im sortierten Eingang befindet.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
is In Trash()
Gibt an, ob sich diese Nachricht im Papierkorb befindet.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is in the trash? ${message.isInTrash()}`);
Rückflug
Boolean
: Gibt an, ob sich diese Nachricht im Papierkorb befindet.
is Starred()
Gibt an, ob diese Nachricht mit einem Stern markiert ist.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is starred? ${message.isStarred()}`);
Rückflug
Boolean
– Gibt an, ob diese Nachricht mit einem Stern markiert ist.
is Unread()
Gibt an, ob diese Nachricht ungelesen ist.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message Logger.log(`is unread? ${message.isUnread()}`);
Rückflug
Boolean
: Der Status „Ungelesen“ dieser Nachricht.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
mark Read()
Die Nachricht wird als gelesen markiert.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.markRead(); // Mark as read
Rückflug
Gmail
– Diese GmailMessage, nützlich für die Verknüpfung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
mark Unread()
Die Nachricht wird als ungelesen markiert.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.markUnread(); // Mark as unread
Rückflug
Gmail
– Diese GmailMessage, nützlich für die Verknüpfung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
move To Trash()
Die Nachricht wird in den Papierkorb verschoben.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.moveToTrash(); // Move message to trash
Rückflug
Gmail
– Diese GmailMessage, nützlich für die Verknüpfung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
refresh()
Diese Nachricht und der zugehörige Status werden aus Gmail neu geladen. Das ist nützlich, wenn sich beispielsweise die Labels oder der Lesestatus geändert haben.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const 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
Gmail
– Diese Nachricht für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
reply(body)
Hiermit wird der Absender dieser Nachricht über die Antwortadresse kontaktiert. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.
// Respond to author of message with acknowledgment const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.reply('Got your message');
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Den Text der E-Mail. |
Rückflug
Gmail
– Diese Nachricht ist für die Verkettung nützlich.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
reply(body, options)
Hiermit wird an den Absender dieser Nachricht mit der Antwortadresse geantwortet. Optionale Argumente sind zulässig.
Die E-Mail kann sowohl Nur-Text als auch einen HTML-Textkörper enthalten. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.
// Respond with HTML body text const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.reply('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', noReply: true, });
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Den Text der E-Mail. |
options | Object | Ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | Blob | eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen |
bcc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen für die BCC-Funktion |
cc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf Cc gesetzt werden sollen |
from | String | Die Adresse, von der die E-Mail gesendet werden soll. Sie muss einer der von Gmail zurückgegebenen Werte sein. |
html | String | Wenn dieses Attribut festgelegt ist, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inline -Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben. |
inline | Object | ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (String ) zu Bilddaten (Blob ); dabei wird davon ausgegangen, dass der Parameter html verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält |
name | String | den Namen des Absenders der E-Mail (Standard: Name des Nutzers) |
no | Boolean | true , wenn die E-Mail von einer generischen E-Mail-Adresse ohne Antwortfunktion gesendet werden soll, um Empfänger davon abzuhalten, auf E-Mails zu antworten. Diese Option ist nur für Google Workspace-Konten verfügbar, nicht für Gmail-Nutzer. |
reply | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail, maximal 250 Zeichen. |
Rückflug
Gmail
– Diese Nachricht ist für die Verkettung nützlich.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
reply All(body)
Antworten an den Absender über die Adresse „An:“ und an alle Empfänger dieser Nachricht. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.
// Respond to all recipients (except bcc'd) of last email in thread with // acknowledgment const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.replyAll('Got your message');
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Den Text der E-Mail. |
Rückflug
Gmail
– Diese Nachricht ist nützlich für die Verkettung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
reply All(body, options)
Hiermit antworten Sie dem Absender dieser Nachricht über die Adresse „An“ und alle Empfänger mit optionalen Argumenten.
Die E-Mail kann sowohl Nur-Text als auch einen HTML-Textkörper enthalten. Die Größe der E-Mail (einschließlich Kopfzeilen) ist kontingentiert.
// Respond with HTML body text const firstThread = GmailApp.getInboxThreads(0, 1)[0]; const message = firstThread.getMessages()[0]; message.replyAll('incapable of HTML', { htmlBody: '<b>some HTML body text</b>', noReply: true, });
Parameter
Name | Typ | Beschreibung |
---|---|---|
body | String | Den Text der E-Mail. |
options | Object | Ein JavaScript-Objekt, das die unten aufgeführten erweiterten Parameter angibt. |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | Blob | eine Reihe von Dateien, die mit der E-Mail gesendet werden sollen |
bcc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen für die BCC-Funktion |
cc | String | eine durch Kommas getrennte Liste der E-Mail-Adressen, die auf Cc gesetzt werden sollen |
from | String | Die Adresse, von der die E-Mail gesendet werden soll. Sie muss einer der von Gmail zurückgegebenen Werte sein. |
html | String | Wenn dieses Attribut festgelegt ist, wird es von Geräten, die HTML rendern können, anstelle des erforderlichen „body“-Arguments verwendet. Sie können ein optionales inline -Feld in den HTML-Text einfügen, wenn Sie Bilder in Ihre E-Mail eingebettet haben. |
inline | Object | ein JavaScript-Objekt mit einer Zuordnung von Bildschlüsseln (String ) zu Bilddaten (Blob ); dabei wird davon ausgegangen, dass der Parameter html verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält |
name | String | den Namen des Absenders der E-Mail (Standard: Name des Nutzers) |
no | Boolean | true , wenn die E-Mail von einer generischen E-Mail-Adresse ohne Antwortfunktion gesendet werden soll, um Empfänger davon abzuhalten, auf E-Mails zu antworten. Diese Option ist nur für Google Workspace-Konten verfügbar, nicht für Gmail-Nutzer. |
reply | String | eine E-Mail-Adresse, die als Standard-Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers) |
subject | String | Eine neue Betreffzeile für die E-Mail, maximal 250 Zeichen. |
Rückflug
Gmail
– Diese Nachricht ist für die Verkettung nützlich.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
star()
Die Nachricht wird mit einem Stern markiert.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.star(); // Star the message
Rückflug
Gmail
– Diese GmailMessage, nützlich für die Verknüpfung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
unstar()
Die Markierung für die Nachricht wird aufgehoben.
const thread = GmailApp.getInboxThreads(0, 1)[0]; // Get first thread in inbox const message = thread.getMessages()[0]; // Get first message message.unstar(); // Unstar the message
Rückflug
Gmail
– Diese GmailMessage, nützlich für die Verknüpfung.
Autorisierung
Scripts, die diese Methode verwenden, erfordern eine Autorisierung mit mindestens einem der folgenden Bereiche oder geeigneten Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/