REST Resource: users.messages

Recurso: mensagem

Uma mensagem de e-mail.

Representação JSON 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
Campos
id

string

O ID imutável da mensagem.
threadId

string

O ID da conversa a que a mensagem pertence. Para adicionar uma mensagem ou rascunho a uma conversa, é preciso atender aos seguintes critérios:

  1. O threadId solicitado precisa ser especificado no Message ou Draft.Message que você fornece com a solicitação.
  2. Os cabeçalhos References e In-Reply-To precisam ser definidos de acordo com o padrão RFC 2822.
  3. Os cabeçalhos Subject precisam ser iguais.
labelIds[]

string

Lista de IDs dos rótulos aplicados a esta mensagem.
snippet

string

Uma parte curta do texto da mensagem.
historyId

string

O ID do último registro de histórico que modificou essa mensagem.
internalDate

string (int64 format)

O carimbo de data/hora de criação da mensagem interna (ms de época), que determina a ordem na caixa de entrada. Para e-mails recebidos normalmente pelo SMTP, esse valor representa a hora em que a mensagem foi aceita originalmente pelo Google, o que é mais confiável do que o cabeçalho Date. No entanto, para e-mails migrados pela API, é possível configurar o cliente para que ele seja baseado no cabeçalho Date.
payload

object (MessagePart)

A estrutura de e-mail analisada nas partes da mensagem.
sizeEstimate

integer

Tamanho estimado da mensagem em bytes.
raw

string (bytes format)

A mensagem de e-mail inteira em uma string codificada em base64url e formatada de acordo com o RFC 2822. Retornado nas respostas messages.get e drafts.get quando o parâmetro format=RAW é fornecido.

Uma string codificada em base64.

MessagePart

Uma única parte da mensagem MIME.

Representação JSON 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Campos
partId

string

O ID imutável da parte da mensagem.
mimeType

string

O tipo MIME da parte da mensagem.
filename

string

O nome do arquivo anexado. Presente apenas se a parte da mensagem representar um anexo.
headers[]

object (Header)

Lista de cabeçalhos desta parte da mensagem. A parte da mensagem de nível superior, que representa todo o payload da mensagem, contém os cabeçalhos de e-mail RFC 2822 padrão, como To, From e Subject.
body

object (MessagePartBody)

O corpo da parte da mensagem para essa parte, que pode estar vazio para partes de mensagens MIME do contêiner.
parts[]

object (MessagePart)

As partes da mensagem MIME filha desta parte. Isso se aplica apenas a partes de mensagens MIME de contêiner, por exemplo, multipart/*. Para tipos de parte de mensagem MIME que não são contêineres, como text/plain, esse campo fica vazio. Para mais informações, consulte a RFC 1521.
Representação JSON 
{
  "name": string,
  "value": string
}
Campos
name

string

O nome do cabeçalho antes do separador :. Por exemplo, To.
value

string

O valor do cabeçalho após o separador :. Por exemplo, someuser@example.com.

Métodos

batchDelete

 Exclui várias mensagens por ID.

batchModify

 Modifica os rótulos das mensagens especificadas.

delete

 Exclui a mensagem especificada imediatamente e permanentemente.

get

 Recebe a mensagem especificada.

import

 Importa uma mensagem apenas para a caixa de entrada desse usuário, com a classificação e a verificação de entrega de e-mail padrão, semelhante à recepção por SMTP.

insert

 Insere diretamente uma mensagem apenas na caixa de e-mails do usuário, semelhante a IMAP APPEND, ignorando a maioria da verificação e classificação.

list

 Lista as mensagens na caixa de e-mails do usuário.

modify

 Modifica os rótulos da mensagem especificada.

send

 Envia a mensagem especificada aos destinatários nos cabeçalhos To, Cc e Bcc.

trash

 Move a mensagem especificada para a lixeira.

untrash

 Remove a mensagem especificada da lixeira.