Diese Seite wurde von der Cloud Translation API übersetzt.

Class GmailDraft

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

GmailApp.createDraft(recipient, subject, body)

`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/

Weitere Informationen

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