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, se deben cumplir los siguientes criterios:

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

Es 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. Para los correos electrónicos recibidos por SMTP normales, esto representa la hora en la que Google aceptó originalmente el mensaje, que es más confiable que el encabezado Date. Sin embargo, en el caso del correo electrónico migrado a 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

Tamaño estimado del mensaje en bytes.
raw

string (bytes format)

El mensaje de correo electrónico completo en una string codificada en base64url con formato RFC 2822. 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

El tipo de 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)

Lista de encabezados en esta parte del mensaje. Para la parte del mensaje de nivel superior, que representa toda la carga útil 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 de mensajes MIME del contenedor.
parts[]

object (MessagePart)

Las partes secundarias del mensaje MIME de esta parte. Esto solo se aplica a las partes de los mensajes MIME del 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 de inmediato y permanentemente el mensaje especificado.

get

 Obtiene el mensaje especificado.

import

 Importa un mensaje solo en el buzón de este usuario, con un análisis de entrega de correo electrónico estándar y clasificación 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 omite la mayor parte del análisis y la clasificación.

list

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