Borradores
Cada operación de este grupo: lo que acepta, lo que devuelve y los errores con los que puede responder.
Operaciones
GET/drafts
List drafts
Requires the drafts:read scope.
Parámetros de consulta
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.
Al menos 1Como máximo 100pageTokenstringOpaque. Pass back what you were given, never construct one.
Devuelve
A page of drafts.
Errores
Los errores que puede devolver cualquier operación400401403404422500Catálogo de errores
También disponible en
POST/drafts
Create a draft
Requires the drafts:write scope.
Devuelve
Created.
Errores
Los errores que puede devolver cualquier operación400401403404422500Catálogo de errores
También disponible en
GET/drafts/{id}
Retrieve a draft
Requires the drafts:read scope.
Parámetros de ruta
idstringObligatorioDraft id, which starts with
draft-.
Devuelve
The draft.
Errores
Los errores que puede devolver cualquier operación400401403404422500Catálogo de errores
También disponible en
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.
Parámetros de ruta
idstringObligatorioDraft id, which starts with
draft-.
Devuelve
Saved.
Errores
Los errores que puede devolver cualquier operación400401403404422500Catálogo de errores
También disponible en
DELETE/drafts/{id}
Delete a draft
Requires the drafts:write scope.
Parámetros de ruta
idstringObligatorioDraft id, which starts with
draft-.
Devuelve
Deleted.
Errores
Los errores que puede devolver cualquier operación400401403404422500Catálogo de errores