Method: users.threads.get

Obtiene el subproceso especificado.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
userId

string

La dirección de correo electrónico del usuario. Se puede usar el valor especial me para indicar el usuario autenticado.

id

string

ID del subproceso que se recuperará.

Parámetros de consulta

Parámetros
format

enum (Format)

Es el formato en el que se devolverán los mensajes.

metadataHeaders[]

string

Cuando se proporciona y el formato es METADATA, solo se incluyen los encabezados especificados.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Thread.

Alcances de autorización

Se necesita uno de los siguientes permisos de 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 obtener más información, consulta OAuth 2.0 Overview.

Formato

Enums
full Devuelve los datos completos del mensaje de correo electrónico con el contenido del cuerpo analizado en el campo payload. No se usa el campo raw. No se puede usar el formato cuando se accede a la API con el permiso gmail.metadata.
metadata Solo devuelve los IDs, las etiquetas y los encabezados de los mensajes de correo electrónico.
minimal Solo devuelve los IDs y las etiquetas de los mensajes de correo electrónico; no devuelve los encabezados, el cuerpo ni la carga útil de los correos electrónicos.