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

Es el ID del subproceso al que pertenece el mensaje. Para agregar un mensaje o un borrador a una conversación, se deben cumplir los siguientes criterios:

  1. El threadId solicitado se debe especificar en el Message o Draft.Message que proporcionas 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

Es la lista de IDs de las etiquetas aplicadas a este mensaje.
snippet

string

Es una parte breve del texto del mensaje.
historyId

string

Es el ID del último registro de historial que modificó este mensaje.
internalDate

string (int64 format)

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

object (MessagePart)

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

integer

Es el tamaño estimado en bytes del mensaje.
raw

string (bytes format)

Es el mensaje de correo electrónico completo en una cadena con formato RFC 2822 y codificación 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 del 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 MIME de la parte del mensaje.
filename

string

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

object (Header)

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

object (MessagePartBody)

Es el cuerpo de la parte del mensaje para 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 del contenedor, por ejemplo, multipart/*. Para los tipos de partes de mensajes 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

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

string

Es 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 de forma inmediata y permanente el mensaje especificado.

get

 Obtiene el mensaje especificado.

import

 Importa un mensaje solo en el buzón de este usuario, con un análisis y una clasificación de entrega de correo electrónico estándar similares a los que se reciben a través de SMTP.

insert

 Inserta un mensaje directamente en el buzón de este usuario, de manera similar a IMAP APPEND, y omite la mayoría de los análisis y la clasificación.

list

 Muestra una lista de los mensajes en el 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

 Quita el mensaje especificado de la papelera.