REST Resource: users.messages

Risorsa: Message

Un messaggio email.

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

string

L'ID non modificabile 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 threadId richiesto deve essere specificato nel Message o nel Draft.Message che fornisci con la 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 degli 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 (in millisecondi), che determina l'ordine nella posta in arrivo. Per le email ricevute tramite SMTP, questo valore rappresenta l'ora in cui il messaggio è stato originariamente accettato da Google, che è più affidabile dell'intestazione Date. Tuttavia, per la posta di cui è stata eseguita la migrazione tramite API, può essere configurata dal client in modo che si basi sull'intestazione Date.
payload

object (MessagePart)

La struttura 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 con codifica base64url e formattazione RFC 2822. Restituiti nelle risposte messages.get e drafts.get quando viene fornito il parametro format=RAW.

Una stringa con codifica in base64.
classificationLabelValues[]

object (ClassificationLabelValue)

Valori dell'etichetta di classificazione nel messaggio. È possibile eseguire query sugli schemi di etichette di classificazione disponibili utilizzando l'API Google Drive Labels. Ogni ID etichetta di classificazione deve essere univoco. Se vengono forniti ID duplicati, ne verrà conservato solo uno e la selezione è arbitraria. Utilizzato solo per gli account Google Workspace. È previsto un limite di 20 valori di etichetta di classificazione per richiesta. Se i valori dell'etichetta di classificazione superano il numero massimo consentito, la richiesta non riesce.

MessagePart

Una singola parte del messaggio MIME.

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

string

L'ID non modificabile della parte del messaggio.
mimeType

string

Il tipo MIME della parte del messaggio.
filename

string

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

object (Header)

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

object (MessagePartBody)

Il corpo della parte del messaggio per questa parte, che potrebbe essere vuoto per le parti del messaggio MIME del contenitore.
parts[]

object (MessagePart)

Le parti del messaggio MIME secondario di questa parte. Questo vale solo per le parti del messaggio MIME del contenitore, ad esempio multipart/*. Per i tipi di parti di messaggi MIME non contenitore, come text/plain, questo campo è vuoto. Per saperne di più, 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.

ClassificationLabelValue

Etichette di classificazione applicate al messaggio email. Le etichette di classificazione sono diverse dalle etichette della Posta in arrivo di Gmail. Utilizzato solo per gli account Google Workspace. Scopri di più sulle etichette di classificazione.

Rappresentazione JSON 
{
  "labelId": string,
  "fields": [
    {
      object (ClassificationLabelFieldValue)
    }
  ]
}
Campi
labelId

string

Obbligatorio. L'ID etichetta di classificazione alfanumerica canonica o non elaborata. Corrisponde al campo ID della risorsa Etichetta di Google Drive.
fields[]

object (ClassificationLabelFieldValue)

Valori dei campi per l'ID etichetta di classificazione specificato.

ClassificationLabelFieldValue

Valori dei campi per un'etichetta di classificazione.

Rappresentazione JSON 
{
  "fieldId": string,
  "selection": string
}
Campi
fieldId

string

Obbligatorio. L'ID campo per il valore dell'etichetta di classificazione. Mappa al campo ID dell'oggetto Label.Field di Google Drive.
selection

string

ID scelta di selezione per l'opzione di selezione. Deve essere impostato solo se il tipo di campo è SELECTION nell'oggetto Label.Field di Google Drive. Mappa al campo id della risorsa Label.Field.SelectionOptions di Google Drive.

Metodi

batchDelete

 Elimina molti messaggi in base all'ID messaggio.

batchModify

 Modifica le etichette e i valori delle etichette di classificazione nei messaggi specificati.

delete

 Elimina immediatamente e definitivamente il messaggio specificato.

get

 Recupera il messaggio specificato.

import

 Importa un messaggio solo nella casella di posta di questo utente, con scansione e classificazione standard della consegna delle email simili alla ricezione tramite SMTP.

insert

 Inserisce direttamente un messaggio nella casella di posta di questo utente in modo simile a IMAP APPEND, ignorando la maggior parte della scansione e della classificazione.

list

 Elenca i messaggi nella casella di posta dell'utente.

modify

 Modifica le etichette e i valori dell'etichetta di classificazione nel 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.