Rascunhos
Cada operação deste grupo: o que aceita, o que devolve e os erros com que pode responder.
Operações
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.
Pelo menos 1No máximo 100pageTokenstringOpaque. Pass back what you were given, never construct one.
Devolve
A page of drafts.
Erros
Os erros que qualquer operação pode devolver400401403404422500Catálogo de erros
Também disponível em
POST/drafts
Create a draft
Requires the drafts:write scope.
Devolve
Created.
Erros
Os erros que qualquer operação pode devolver400401403404422500Catálogo de erros
Também disponível em
GET/drafts/{id}
Retrieve a draft
Requires the drafts:read scope.
Parâmetros de caminho
idstringObrigatórioDraft id, which starts with
draft-.
Devolve
The draft.
Erros
Os erros que qualquer operação pode devolver400401403404422500Catálogo de erros
Também disponível em
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 caminho
idstringObrigatórioDraft id, which starts with
draft-.
Devolve
Saved.
Erros
Os erros que qualquer operação pode devolver400401403404422500Catálogo de erros
Também disponível em
DELETE/drafts/{id}
Delete a draft
Requires the drafts:write scope.
Parâmetros de caminho
idstringObrigatórioDraft id, which starts with
draft-.
Devolve
Deleted.
Erros
Os erros que qualquer operação pode devolver400401403404422500Catálogo de erros