Method: users.threads.get

Recebe a conversa especificada.

Solicitação HTTP

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

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.
id

string

O ID da conversa a ser recuperada.

Parâmetros de consulta

Parâmetros
format

enum (Format)

O formato em que as mensagens serão retornadas.
metadataHeaders[]

string

Quando fornecido e o formato é METADATA, inclua apenas os cabeçalhos especificados.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Thread.

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
  • https://www.googleapis.com/auth/gmail.addons.current.message.metadata
  • https://www.googleapis.com/auth/gmail.addons.current.message.readonly
  • https://www.googleapis.com/auth/gmail.addons.current.message.action

Para mais informações, consulte OAuth 2.0 Overview.

Formato

Tipos enumerados
full Retorna todos os dados da mensagem de e-mail com o conteúdo do corpo analisado no campo payload. O campo raw não é usado. O formato não pode ser usado ao acessar a API com o escopo gmail.metadata.
metadata Retorna apenas IDs de mensagens de e-mail, marcadores e cabeçalhos de e-mail.
minimal Retorna apenas IDs e marcadores de mensagens de e-mail, não os cabeçalhos, o corpo ou o payload.