Entwürfe
Jede Operation in dieser Gruppe: was sie annimmt, was sie zurückgibt und mit welchen Fehlern sie antworten kann.
Operationen
GET/drafts
List drafts
Requires the drafts:read scope.
Query-Parameter
querystringThe same search syntax as
GET /threads, read against each draft's subject, sender and the first 4,000 characters of its body. Plain words match loosely and a quoted phrase has to appear as written, filler words are dropped when something else is left to search for, and a value the search cannot use is ignored rather than narrowing. Recipients are not searched, soto:,cc:andbcc:match nothing here. The drafts folder always applies, soin:and folderis:operators cannot widen the search beyond drafts,in:anywhereincluded. A draft saved with no subject is stored as(no subject), sosubject:"no subject"finds it.limitintegerDrafts per page, a whole number from 1 to 100. Defaults to 25.
Mindestens 1Höchstens 100pageTokenstringOpaque. Pass back what you were given, never construct one.
Rückgabe
A page of drafts.
Fehler
Die Fehler, die jede Operation zurückgeben kann400401403404422500Fehlerkatalog
Auch verfügbar über
POST/drafts
Create a draft
Requires the drafts:write scope.
Rückgabe
Created.
Fehler
Die Fehler, die jede Operation zurückgeben kann400401403404422500Fehlerkatalog
Auch verfügbar über
GET/drafts/{id}
Retrieve a draft
Requires the drafts:read scope.
Pfadparameter
idstringErforderlichDraft id, which starts with
draft-.
Rückgabe
The draft.
Fehler
Die Fehler, die jede Operation zurückgeben kann400401403404422500Fehlerkatalog
Auch verfügbar über
PATCH/drafts/{id}
Update a draft
A partial update, not an upsert. An unknown id, or the id of a thread that is not a draft, is a 404. The draft keeps the id you passed, and the response echoes it.
Requires the drafts:write scope.
Pfadparameter
idstringErforderlichDraft id, which starts with
draft-.
Rückgabe
Saved.
Fehler
Die Fehler, die jede Operation zurückgeben kann400401403404422500Fehlerkatalog
Auch verfügbar über
DELETE/drafts/{id}
Delete a draft
Requires the drafts:write scope.
Pfadparameter
idstringErforderlichDraft id, which starts with
draft-.
Rückgabe
Deleted.
Fehler
Die Fehler, die jede Operation zurückgeben kann400401403404422500Fehlerkatalog