Entwürfe sind nicht gesendete Nachrichten mit dem Systemlabel „DRAFT
“.
Die im Entwurf enthaltene Nachricht kann nach dem Erstellen nicht mehr bearbeitet, aber ersetzt werden. In diesem Sinne ist der Ressourcenentwurf einfach ein Container, der eine stabile ID bereitstellt, da sich die zugrunde liegenden Nachrichten-IDs jedes Mal ändern, wenn die Nachricht ersetzt wird.
Nachrichtenressourcen in einem Entwurf verhalten sich ähnlich wie andere Nachrichten, mit Ausnahme der folgenden Unterschiede:
- Nachrichtenentwürfe dürfen nur das Systemlabel
DRAFT
haben. - Beim Senden des Entwurfs wird er automatisch gelöscht und eine neue Nachricht mit einer aktualisierten ID mit dem Systemlabel
SENT
erstellt. Diese Nachricht wird in der Antwortdrafts.send
zurückgegeben.
Inhalt
Nachrichtenentwürfe erstellen
Ihre Anwendung kann mit der Methode drafts.create Entwürfe erstellen. Im Allgemeinen gehen Sie so vor:
- Erstellen Sie eine MIME-Nachricht, die RFC 2822 entspricht.
- Konvertieren Sie die Nachricht in einen base64url-codierten String.
- Erstellen Sie einen Entwurf und legen Sie den Wert des Felds
drafts.message.raw
auf den codierten String fest.
Die folgenden Codebeispiele veranschaulichen den Vorgang.
Java
Python
Entwürfe werden aktualisiert
Ähnlich wie beim Erstellen eines Entwurfs müssen Sie zum Aktualisieren eines Entwurfs im Text Ihrer Anfrage eine Draft
-Ressource angeben, wobei das Feld draft.message.raw
auf einen base64url-codierten String festgelegt ist, der die MIME-Nachricht enthält. Da Nachrichten nicht aktualisiert werden können, wird die im Entwurf enthaltene Nachricht gelöscht und durch die neue MIME-Nachricht aus der Aktualisierungsanfrage ersetzt.
Sie können die aktuelle MIME-Nachricht im Entwurf abrufen, indem Sie drafts.get
mit dem Parameter format=raw
aufrufen.
Weitere Informationen finden Sie unter drafts.update
.
Entwürfe werden gesendet
Beim Senden eines Entwurfs können Sie die Nachricht unverändert oder wie eine aktualisierte Nachricht senden. Wenn Sie den Inhalt des Entwurfs mit einer neuen Nachricht aktualisieren, geben Sie im Text der drafts.send
-Anfrage eine Draft
-Ressource an, legen den draft.id
des Entwurfs fest, der gesendet werden soll, und das Feld draft.message.raw
auf die neue MIME-Nachricht, die als base64url-codierten String codiert ist. Weitere Informationen finden Sie unter drafts.send
.