Entwürfe
Nicht gesendete Nachrichten, im Postfach gespeichert.
Entwurfs-Tools
| Tool | Was es tut |
|---|---|
| listDrafts | Die Entwürfe, zuletzt gespeicherte zuerst, jeweils mit Betreff, Empfängern und Absender. query durchsucht sie. |
| getDraft | Ein Entwurf vollständig: sein Absender, seine Empfänger, sein Betreff, der Thread, auf den er antwortet, seine Anhänge und sein Inhalt. |
| createDraft | Einen neuen Entwurf speichern, ohne ihn zu senden. Jedes Feld ist optional, und threadId macht ihn zu einer Antwort. |
| updateDraft | Felder eines Entwurfs ändern. Ein weggelassenes Feld behält seinen Wert, und eine Liste ersetzt die gespeicherte vollständig. |
| deleteDraft | Einen Entwurf endgültig löschen. Er landet nicht im Papierkorb. |
Lesen erfordert „Entwürfe lesen“ (drafts:read), und Speichern, Ändern oder Löschen erfordert „Entwürfe erstellen und bearbeiten“ (drafts:write). Ein auf einige Adressen beschränkter Client sieht nur die Entwürfe von diesen Adressen, und ein Entwurf, den er speichert, braucht ein from, als das er senden darf.
Im Chat der App fragen Speichern, Ändern und Löschen eines Entwurfs zuerst nach, sofern Sie es nicht selbst verlangt haben.
Referenz
listDrafts
The unsent drafts in the mailbox, most recently saved first, each with its id, subject, recipients and sender. query searches the subject, the sender and the start of the body. When more follow, the last line gives a pageToken: call again with the same query and that pageToken.
Eingaben
querystringlimitinteger- Mindestens 1Höchstens 100
pageTokenstring
Auch verfügbar über
getDraft
One draft in full: its sender, recipients, subject, the thread it replies to, the names of its attachments and its body as saved. Take the id from listDrafts.
Eingaben
draftIdstringErforderlich- Nicht leer
Auch verfügbar über
createDraft
Save a new draft without sending it, as the composer does when you close it. Every field is optional, and html wins over text when both are given. from is the address it will be sent as, and threadId makes it a reply to that thread. sendEmail with the draft id sends it later.
Eingaben
tostring[]ccstring[]bccstring[]subjectstring- Bis zu 998 Zeichen
htmlstring- Bis zu 1000000 Zeichen
textstring- Bis zu 1000000 Zeichen
fromstringthreadIdstring
Auch verfügbar über
updateDraft
Change fields on a saved draft. A field you leave out keeps its value, and a list you give replaces the saved one whole, so to with one address drops the others. from null clears the sender. Take the id from listDrafts.
Eingaben
draftIdstringErforderlich- Nicht leer
tostring[]ccstring[]bccstring[]subjectstring- Bis zu 998 Zeichen
htmlstring- Bis zu 1000000 Zeichen
textstring- Bis zu 1000000 Zeichen
fromstring- Kann null sein
threadIdstring
Auch verfügbar über
deleteDraft
Delete a draft for good. It does not go to the Bin and cannot be brought back. Take the id from listDrafts.
Eingaben
draftIdstringErforderlich- Nicht leer