REST Resource: users.messages

Risorsa: messaggio

Un messaggio email.

Rappresentazione JSON
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
Campi
id

string

L'ID immutabile del messaggio.

threadId

string

L'ID del thread a cui appartiene il messaggio. Per aggiungere un messaggio o una bozza a un thread, devono essere soddisfatti i seguenti criteri:

  1. Il valore threadId richiesto deve essere specificato nel Message o nel Draft.Message indicato nella richiesta.
  2. Le intestazioni References e In-Reply-To devono essere impostate in conformità allo standard RFC 2822.
  3. Le intestazioni Subject devono corrispondere.

labelIds[]

string

Elenco di ID delle etichette applicate a questo messaggio.

snippet

string

Una breve parte del testo del messaggio.

historyId

string

L'ID dell'ultimo record della cronologia che ha modificato questo messaggio.

internalDate

string (int64 format)

Il timestamp di creazione del messaggio interno (epoca ms), che determina l'ordine nella Posta in arrivo. Per le normali email ricevute da SMTP, questo valore rappresenta l'ora in cui il messaggio è stato inizialmente accettato da Google, che è più affidabile dell'intestazione Date. Tuttavia, per la posta sottoposta a migrazione tramite API, può essere configurata in base al client in modo che sia basata sull'intestazione Date.

payload

object (MessagePart)

La struttura dell'email analizzata nelle parti del messaggio.

sizeEstimate

integer

Dimensioni stimate del messaggio in byte.

raw

string (bytes format)

L'intero messaggio email in una stringa in formato RFC 2822 e con codifica base64url. Restituito nelle risposte messages.get e drafts.get quando viene fornito il parametro format=RAW.

Una stringa con codifica Base64.

MessagePart

Una singola parte di un messaggio MIME.

Rappresentazione JSON
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Campi
partId

string

L'ID immutabile della parte del messaggio.

mimeType

string

Il tipo MIME della parte del messaggio.

filename

string

Il nome file dell'allegato. Presente solo se questa parte del messaggio rappresenta un allegato.

headers[]

object (Header)

Elenco di intestazioni in questa parte del messaggio. La parte del messaggio di primo livello, che rappresenta l'intero payload del messaggio, conterrà le intestazioni email RFC 2822 standard come To, From e Subject.

body

object (MessagePartBody)

Il corpo del messaggio per questa parte, che potrebbe essere vuoto per le parti del messaggio MIME del container.

parts[]

object (MessagePart)

Le parti del messaggio MIME figlio di questa parte. Si applica solo alle parti del messaggio MIME del container, ad esempio multipart/*. Per i tipi di parte di messaggi MIME non container, come text/plain, questo campo è vuoto. Per ulteriori informazioni, consulta RFC 1521.

Rappresentazione JSON
{
  "name": string,
  "value": string
}
Campi
name

string

Il nome dell'intestazione prima del separatore :. Ad esempio, To.

value

string

Il valore dell'intestazione dopo il separatore :. Ad esempio, someuser@example.com.

Metodi

batchDelete

Elimina molti messaggi in base all'ID messaggio.

batchModify

Modifica le etichette sui messaggi specificati.

delete

Elimina immediatamente e definitivamente il messaggio specificato.

get

Restituisce il messaggio specificato.

import

Importa un messaggio solo nella casella di posta di questo utente, con una scansione e una classificazione del recapito della posta standard simili alla ricezione tramite SMTP.

insert

Inserisce direttamente un messaggio solo nella casella di posta di questo utente, simile a IMAP APPEND, ignorando la maggior parte dell'analisi e della classificazione.

list

Elenca i messaggi presenti nella casella di posta dell'utente.

modify

Modifica le etichette del messaggio specificato.

send

Invia il messaggio specificato ai destinatari nelle intestazioni To, Cc e Bcc.

trash

Sposta il messaggio specificato nel cestino.

untrash

Rimuove il messaggio specificato dal cestino.