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 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 fornito 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 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 della creazione del messaggio interno (epoch ms), che determina l'ordinamento nella posta in arrivo. Per le normali email ricevute tramite SMTP, indica 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 configurato dal client in base all'intestazione Date.

payload

object (MessagePart)

La struttura dell'email analizzata nelle parti del messaggio.

sizeEstimate

integer

Dimensioni stimate in byte del messaggio.

raw

string (bytes format)

L'intero messaggio email in una stringa con codifica base64url e formattata in RFC 2822. Viene 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 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. La parte di primo livello del messaggio, 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 può 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 dei messaggi MIME non contenitore, come text/plain, questo campo è vuoto. Per ulteriori informazioni, consulta la 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

Consente di eliminare 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 cassetta di posta di questo utente, con scansione e classificazione del recapito delle email standard, simile alla ricezione tramite SMTP.

insert

Inserisce direttamente un messaggio solo nella casella di posta di questo utente, in modo simile a IMAP APPEND, bypassando la maggior parte delle scansioni e delle classificazioni.

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.