Entwürfe sind noch 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:
- Entwürfe dürfen kein anderes Label als das Systemlabel
DRAFT
haben. - Wenn der Entwurf gesendet wird, 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. Das Feld draft.message.raw
muss dabei auf einen base64url-codierten String festgelegt sein, 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 ersetzt, die in der Aktualisierungsanfrage bereitgestellt wird.
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 Sie den draft.id
des zu sendenden Entwurfs fest und geben Sie im Feld draft.message.raw
die neue MIME-Nachricht an, die als base64url-codierten String codiert ist. Weitere Informationen finden Sie unter drafts.send
.