Method: users.messages.get

Obtiene el mensaje especificado.

Solicitud HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{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 mensaje que se recuperará. Por lo general, este ID se recupera con messages.list. El ID también se incluye en el resultado cuando se inserta (messages.insert) o importa (messages.import) un mensaje.

Parámetros de consulta

Parámetros
format

enum (Format)

Es el formato en el que se devolverá el mensaje.
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 Message.

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.