REST Resource: users.messages

Recurso: Mensaje

Un mensaje de correo electrónico

Representación JSON 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
Campos
id

string

El ID inmutable del mensaje.
threadId

string

El ID de la conversación a la que pertenece el mensaje. Para agregar un mensaje o borrador a una conversación, debes cumplir con los siguientes criterios:

  1. El threadId solicitado se debe especificar en los Message o Draft.Message que proporciones con tu solicitud.
  2. Los encabezados References y In-Reply-To deben configurarse de acuerdo con el estándar RFC 2822.
  3. Los encabezados Subject deben coincidir.
labelIds[]

string

Lista de los IDs de las etiquetas que se aplicaron a este mensaje.
snippet

string

Una parte breve del texto del mensaje.
historyId

string

El ID del último registro del historial que modificó este mensaje.
internalDate

string (int64 format)

La marca de tiempo de creación del mensaje interno (ms de época), que determina el orden en la bandeja de entrada. En el caso de los correos electrónicos normales recibidos por SMTP, representa la hora en que Google aceptó originalmente el mensaje, que es más confiable que el encabezado Date. Sin embargo, en el caso del correo migrado por API, el cliente puede configurarlo para que se base en el encabezado Date.
payload

object (MessagePart)

La estructura de correo electrónico analizada en las partes del mensaje.
sizeEstimate

integer

Tamaño estimado en bytes del mensaje.
raw

string (bytes format)

El mensaje de correo electrónico completo en una cadena con formato RFC 2822 y codificada en base64url. Se muestra en las respuestas messages.get y drafts.get cuando se proporciona el parámetro format=RAW.

String codificada en base64.

MessagePart

Una sola parte de mensaje MIME.

Representación JSON 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Campos
partId

string

El ID inmutable de la parte del mensaje.
mimeType

string

Es el tipo de MIME de la parte del mensaje.
filename

string

El nombre del archivo adjunto. Solo está presente si esta parte del mensaje representa un archivo adjunto.
headers[]

object (Header)

Lista de encabezados en esta parte del mensaje. En la parte del mensaje de nivel superior, que representa la carga útil completa del mensaje, contendrá los encabezados de correo electrónico estándar RFC 2822, como To, From y Subject.
body

object (MessagePartBody)

El cuerpo de la parte del mensaje de esta parte, que puede estar vacío para las partes del mensaje MIME del contenedor.
parts[]

object (MessagePart)

Las partes secundarias del mensaje MIME de esta parte. Esto solo se aplica a las partes de mensajes MIME de contenedor, por ejemplo, multipart/*. Para los tipos de parte de mensaje MIME que no son de contenedor, como text/plain, este campo está vacío. Para obtener más información, consulta RFC 1521.
Representación JSON 
{
  "name": string,
  "value": string
}
Campos
name

string

El nombre del encabezado antes del separador :. Por ejemplo, To
value

string

El valor del encabezado después del separador :. Por ejemplo, someuser@example.com

Métodos

batchDelete

 Borra muchos mensajes por ID de mensaje.

batchModify

 Modifica las etiquetas de los mensajes especificados.

delete

 Borra el mensaje especificado de forma inmediata y permanente.

get

 Obtiene el mensaje especificado.

import

 Importa un mensaje solo al buzón de este usuario, con una clasificación y análisis de entrega de correo electrónico estándar similar a la recepción a través de SMTP.

insert

 Inserta directamente un mensaje solo en el buzón de este usuario similar a IMAP APPEND, y evita la mayor parte del análisis y la clasificación.

list

 Muestra una lista de los mensajes del buzón del usuario.

modify

 Modifica las etiquetas del mensaje especificado.

send

 Envía el mensaje especificado a los destinatarios en los encabezados To, Cc y Bcc.

trash

 Mueve el mensaje especificado a la papelera.

untrash

 Elimina el mensaje especificado de la papelera.