Ein vom Nutzer erstellter Nachrichtenentwurf im Gmail-Konto eines Nutzers.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
deleteDraft() | void | Löscht diesen Nachrichtenentwurf. |
getId() | String | Ruft die ID des Nachrichtenentwurfs ab. |
getMessage() | GmailMessage | Gibt eine GmailMessage zurück, die diesen Entwurf darstellt |
getMessageId() | String | Gibt die ID des GmailMessage zurück, der diesen Entwurf darstellt. |
send() | GmailMessage | Sendet diesen E-Mail-Entwurf. |
update(recipient, subject, body) | GmailDraft | Ersetzt den Inhalt dieses Nachrichtenentwurfs. |
update(recipient, subject, body, options) | GmailDraft | Ersetzt den Inhalt dieses Nachrichtenentwurfs durch optionale Argumente. |
Detaillierte Dokumentation
deleteDraft()
Löscht diesen Nachrichtenentwurf.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder draft.deleteDraft(); draft.getMessage(); // Throws exception.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
getId()
Ruft die ID des Nachrichtenentwurfs ab.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var draftId = draft.getId(); var draftById = GmailApp.getDraft(draftId); Logger.log(draft.getMessage().getSubject() == draftById.getMessage().getSubject());
Return
String
: die Entwurfs-ID
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
getMessage()
Gibt eine GmailMessage zurück, die diesen Entwurf darstellt
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var message = draft.getMessage(); Logger.log(message.getSubject());
Return
GmailMessage
: die Nachricht, die den Inhalt dieses Entwurfs darstellt
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
getMessageId()
Gibt die ID des GmailMessage
zurück, der diesen Entwurf darstellt.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var messageId = draft.getMessageId(); Logger.log(messageId == draft.getMessage().getId());
Return
String
: die Nachrichten-ID
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
send()
Sendet diesen E-Mail-Entwurf. Die Größe der E-Mail (einschließlich Header) ist begrenzt.
var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var msg = draft.send(); // Send it Logger.log(msg.getDate()); // Should be approximately the current timestamp
Return
GmailMessage
: die neu gesendete Nachricht
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
update(recipient, subject, body)
Ersetzt den Inhalt dieses Nachrichtenentwurfs. Die Größe der E-Mail (einschließlich Header) ist begrenzt.
// The code below will update a draft email with the current date and time. var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var now = new Date(); draft.update("mike@example.com", "current time", "The time is: " + now.toString());
Parameter
Name | Typ | Beschreibung |
---|---|---|
recipient | String | durch Kommas getrennte Liste von E-Mail-Adressen |
subject | String | Betreff der E-Mail (maximal 250 Zeichen) |
body | String | E-Mail-Text |
Return
GmailDraft
– der kürzlich aktualisierte Entwurf
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/
Weitere Informationen
update(recipient, subject, body, options)
Ersetzt den Inhalt dieses Nachrichtenentwurfs durch optionale Argumente. Die E-Mail kann reinen Text oder HTML-Text enthalten. Die Größe der E-Mail (einschließlich Header) ist begrenzt.
// Update a draft email with a file from Google Drive attached as a PDF. var draft = GmailApp.getDrafts()[0]; // The first draft message in the drafts folder var file = DriveApp.getFileById('1234567890abcdefghijklmnopqrstuvwxyz'); draft.update('mike@example.com', 'Attachment example', 'Please see attached file.', { attachments: [file.getAs(MimeType.PDF)], name: 'Automatic Emailer Script' });
Parameter
Name | Typ | Beschreibung |
---|---|---|
recipient | String | durch Kommas getrennte Liste von E-Mail-Adressen |
subject | String | Betreff der E-Mail (maximal 250 Zeichen) |
body | String | E-Mail-Text |
options | Object | Ein JavaScript-Objekt, das erweiterte Parameter angibt, wie unten aufgeführt |
Erweiterte Parameter
Name | Typ | Beschreibung |
---|---|---|
attachments | BlobSource[] | Ein Array von Dateien, die mit der E-Mail gesendet werden sollen |
bcc | String | eine durch Kommas getrennte Liste von E-Mail-Adressen als Bcc |
cc | String | eine durch Kommas getrennte Liste von E-Mail-Adressen, die in Cc gesetzt werden sollen |
from | String | Die Adresse, von der die E-Mail gesendet werden soll. Diese muss einer der von GmailApp.getAliases() zurückgegebenen Werte sein. |
htmlBody | String | Ist die Richtlinie festgelegt, verwenden Geräte, die HTML rendern können, dieses Argument anstelle des erforderlichen Textarguments. Wenn du Inline-Bilder für deine E-Mail hast, kannst du ein optionales inlineImages -Feld im HTML-Text hinzufügen. |
inlineImages | Object | Ein JavaScript-Objekt, das eine Zuordnung vom Bildschlüssel (String ) zu Bilddaten (BlobSource ) enthält. Dabei wird davon ausgegangen, dass der Parameter htmlBody verwendet wird und Verweise auf diese Bilder im Format <img src="cid:imageKey" /> enthält. |
name | String | den Namen des Absenders der E-Mail (Standard: der Name des Nutzers) |
replyTo | String | eine E-Mail-Adresse, die als standardmäßige Antwortadresse verwendet werden soll (Standard: die E-Mail-Adresse des Nutzers) |
Return
GmailDraft
– der kürzlich aktualisierte Entwurf
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche oder entsprechenden Bereichen aus der zugehörigen REST API:
-
https://mail.google.com/