REST Resource: users.messages

Recurso: Message

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 del subproceso al que pertenece el mensaje. Para agregar un mensaje o borrador a una conversación, deben cumplirse los siguientes criterios:

  1. El threadId solicitado debe especificarse en el Message o el Draft.Message que proporcionas con tu solicitud.
  2. Los encabezados References y In-Reply-To deben configurarse en conformidad con el estándar RFC 2822.
  3. Los encabezados Subject deben coincidir.

labelIds[]

string

Lista de ID de etiquetas aplicadas a este mensaje.

snippet

string

Una pequeña parte del texto del mensaje.

historyId

string

El ID del último registro histórico que modificó este mensaje.

internalDate

string (int64 format)

La marca de tiempo de creación de mensajes interna (epoch ms), que determina el orden en Recibido. En el caso del correo electrónico normal que recibe el SMTP, representa la hora en que Google aceptó el mensaje originalmente, que es más confiable que el encabezado Date. Sin embargo, para el correo migrado con 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 en bytes del mensaje.

raw

string (bytes format)

El mensaje de correo electrónico completo en una string 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.

MensajeDepartamental

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

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 de RFC 2822, como To, From y Subject.

body

object (MessagePartBody)

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 del mensaje MIME secundario de esta parte. Esto solo se aplica a las partes del mensaje MIME del contenedor, por ejemplo, multipart/*. Para los tipos de parte de mensaje MIME que no son contenedores, 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 escaneo y entrega de correo electrónico estándar similares a los recibidos a través de SMTP.

insert

Inserta directamente un mensaje en la casilla de correo de este usuario, similar a IMAP APPEND, sin pasar por la mayor parte de la búsqueda y la clasificación.

list

Muestra una lista de los mensajes en la casilla de correo del usuario.

modify

Modifica las etiquetas del mensaje especificado.

send

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

trash

Mueve el mensaje especificado a la papelera.

untrash

Elimina el mensaje especificado de la papelera.