Brouillons
Chaque opération de ce groupe : ce qu'elle accepte, ce qu'elle retourne et les erreurs qu'elle peut renvoyer.
Opérations
GET/drafts
List drafts
Requires the drafts:read scope.
Paramètres de requête
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.
Au moins 1Au plus 100pageTokenstringOpaque. Pass back what you were given, never construct one.
Retourne
A page of drafts.
Erreurs
Les erreurs que toute opération peut renvoyer400401403404422500Catalogue des erreurs
Aussi disponible dans
POST/drafts
Create a draft
Requires the drafts:write scope.
Retourne
Created.
Erreurs
Les erreurs que toute opération peut renvoyer400401403404422500Catalogue des erreurs
Aussi disponible dans
GET/drafts/{id}
Retrieve a draft
Requires the drafts:read scope.
Paramètres de chemin
idstringObligatoireDraft id, which starts with
draft-.
Retourne
The draft.
Erreurs
Les erreurs que toute opération peut renvoyer400401403404422500Catalogue des erreurs
Aussi disponible dans
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.
Paramètres de chemin
idstringObligatoireDraft id, which starts with
draft-.
Retourne
Saved.
Erreurs
Les erreurs que toute opération peut renvoyer400401403404422500Catalogue des erreurs
Aussi disponible dans
DELETE/drafts/{id}
Delete a draft
Requires the drafts:write scope.
Paramètres de chemin
idstringObligatoireDraft id, which starts with
draft-.
Retourne
Deleted.
Erreurs
Les erreurs que toute opération peut renvoyer400401403404422500Catalogue des erreurs