Method: users.threads.list

Lista as conversas na caixa de entrada 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 esse campo é 500.
pageToken

string

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

string

Retorna apenas as linhas de execução que correspondem à consulta especificada. Suporta 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 usando o escopo gmail.metadata.
labelIds[]

string

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

boolean

Incluir linhas 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 linhas de execução. Cada recurso de linha de execução não contém uma lista de messages. A lista de messages para uma determinada linha de execução pode ser extraída 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.