Diese Seite wurde von der Cloud Translation API übersetzt.

Class GmailDraft

Ein von einem Nutzer im Gmail-Konto eines Nutzers erstellter Nachrichtenentwurf.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`deleteDraft()`	`void`	Löscht diesen Nachrichtenentwurf.
`getId()`	`String`	Ruft die ID dieses Nachrichtenentwurfs ab.
`getMessage()`	`GmailMessage`	Gibt eine GmailMessage zurück, die diesen Entwurf darstellt.
`getMessageId()`	`String`	Gibt die ID des `GmailMessage`-Objekts zurück, das 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

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

Rückflug

String – die Entwurfs-ID

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/

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

Rückflug

GmailMessage: die Nachricht, die den Inhalt dieses Entwurfs darstellt

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/

`getMessageId()`

Gibt die ID des GmailMessage-Objekts zurück, das 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());

Rückflug

String: die Nachrichten-ID

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/

`send()`

Sendet diesen E-Mail-Entwurf. Die Größe der E-Mail (einschließlich Header) ist kontingent 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

Rückflug

GmailMessage: die neu gesendete 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/

`update(recipient, subject, body)`

Ersetzt den Inhalt dieses Nachrichtenentwurfs. Die Größe der E-Mail (einschließlich Header) ist kontingent 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

Rückflug

GmailDraft – der aktualisierte Entwurf

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

GmailApp.createDraft(recipient, subject, body)

`update(recipient, subject, body, options)`

Ersetzt den Inhalt dieses Nachrichtenentwurfs durch optionale Argumente. Die E-Mail kann Folgendes enthalten: Nur-Text- oder HTML-Textkörper. Die Größe der E-Mail (einschließlich Header) ist kontingent 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[]`	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 festgelegt, wird HTML-Code von Geräten, die HTML rendern können, verwendet des erforderlichen Arguments "body"; können Sie ein optionales `inlineImages`-Feld in HTML Text, wenn Sie Inline-Bilder für Ihre E-Mail haben
`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)

Rückflug

GmailDraft – der aktualisierte Entwurf

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

GmailApp.createDraft(recipient, subject, body, options)