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. L'oggetto threadId richiesto deve essere specificato nel Message o nel Draft.Message che fornisci 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 il messaggio.

internalDate

string (int64 format)

Il timestamp interno di creazione del messaggio (epoca ms), che determina l'ordine nella posta in arrivo. Per le normali email ricevute via SMTP, questo valore rappresenta il momento in cui il messaggio è stato originariamente accettato da Google, più affidabile rispetto all'intestazione Date. Tuttavia, per la posta di cui è stata eseguita la migrazione tramite API, può essere configurata dal client in modo che sia basata sull'intestazione Date.

payload

object (MessagePart)

La struttura dell'email analizzata nelle parti del messaggio.

sizeEstimate

integer

Stima delle dimensioni in byte del messaggio.

raw

string (bytes format)

L'intero messaggio email in una stringa formattata RFC 2822 e codificata in 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 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 immutabile della parte del messaggio.

mimeType

string

Il tipo MIME della parte del messaggio.

filename

string

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

headers[]

object (Header)

Elenco di intestazioni in questa parte del messaggio. Per la parte di primo livello del messaggio, che rappresenta l'intero payload, conterrà le intestazioni email RFC 2822 standard, quali 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 parte dei 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 dei messaggi specificati.

delete

Elimina immediatamente e definitivamente il messaggio specificato.

get

Recupera il messaggio specificato.

import

Importa un messaggio solo nella casella di posta dell'utente, con scansione e classificazione standard del recapito delle email simili a quelle della ricezione tramite SMTP.

insert

Inserisce direttamente un messaggio solo nella casella di posta dell'utente simile a IMAP APPEND, bypassando la maggior parte delle operazioni di scansione e classificazione.

list

Elenca i messaggi 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.