Method: users.drafts.list

Lista os rascunhos na caixa de e-mails do usuário.

Solicitação HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/drafts

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
userId

string

O endereço de e-mail do usuário. O valor especial me pode ser usado para indicar o usuário autenticado.

Parâmetros de consulta

Parâmetros
maxResults

integer (uint32 format)

Número máximo de rascunhos a serem devolvidos. O padrão desse campo é 100. O valor máximo permitido para este campo é 500.

pageToken

string

Token da página para recuperar uma página específica de resultados na lista.

q

string

Retorna apenas mensagens de rascunho que correspondem à consulta especificada. Oferece suporte ao mesmo formato de consulta da caixa de pesquisa do Gmail. Por exemplo, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread".

includeSpamTrash

boolean

Incluir rascunhos de SPAM e TRASH nos resultados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se bem-sucedido, o corpo da resposta exibirá os dados com a seguinte estrutura:

Representação JSON
{
  "drafts": [
    {
      object (Draft)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
Campos
drafts[]

object (Draft)

Lista de rascunhos. A propriedade Message em cada recurso Draft contém apenas um id e um threadId. O método messages.get busca detalhes adicionais da mensagem.

nextPageToken

string

Token para recuperar a próxima página de resultados da lista.

resultSizeEstimate

integer (uint32 format)

Número total estimado de resultados.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.compose
  • https://www.googleapis.com/auth/gmail.readonly

Para mais informações, consulte o Guia de autorização.