Method: users.threads.list

Lista as conversas na caixa de correio do usuário.

Solicitação HTTP

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

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 linhas de execução a serem retornadas. O padrão desse campo é 100. O valor máximo permitido para este campo é 500.

pageToken

string

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

q

string

Retorna apenas linhas de execução que correspondem à consulta especificada. Compatível com o mesmo formato de consulta da caixa de pesquisa do Gmail. Por exemplo, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread". O parâmetro não pode ser usado ao acessar a API com o escopo gmail.metadata.

labelIds[]

string

Retorna apenas conversas com rótulos que correspondem a todos os IDs de rótulo especificados.

includeSpamTrash

boolean

Inclui conversas 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
{
  "threads": [
    {
      object (Thread)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
Campos
threads[]

object (Thread)

Lista de conversas. Observe que cada recurso de linha de execução não contém uma lista de messages. A lista de messages de uma determinada linha de execução pode ser buscada usando o método threads.get.

nextPageToken

string

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

resultSizeEstimate

integer (uint32 format)

Número total estimado de resultados.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

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