REST Resource: customers.quarantinedMessages

Risorsa: QuarantinedMessage

La risorsa QuarantinedMessage rappresenta un'email trattenuta in una quarantena amministrativa.

Rappresentazione JSON 
{
  "name": string,
  "messageId": string,
  "messageOwner": string,
  "quarantines": [
    string
  ],
  "receiveTime": string,
  "direction": enum (Direction),
  "state": enum (State),
  "retentionExpireTime": string,
  "triggeredRules": [
    {
      object (TriggeredRule)
    }
  ],
  "content": {
    object (MessageContent)
  },
  "rawMessage": string
}
Campi
name

string

Identificatore. Il nome della risorsa del messaggio in quarantena. Formato: customers/{customer_id}/quarantinedMessages/{quarantined_message_id}
messageId

string

Solo output. L'ID immutabile del messaggio Gmail sottostante.
messageOwner

string

Solo output. L'indirizzo email del proprietario di questo messaggio.
quarantines[]

string

Solo output. I nomi delle risorse delle quarantene a cui appartiene questo messaggio. Formato: customers/{customer_id}/quarantines/{quarantine_id}
receiveTime

string (Timestamp format)

Solo output. Il timestamp di ricezione del messaggio.
direction

enum (Direction)

Solo output. La direzione del messaggio (ad es. IN ENTRATA, IN USCITA).
state

enum (State)

Solo output. Lo stato di elaborazione attuale del messaggio.
retentionExpireTime

string (Timestamp format)

Solo output. Il timestamp fino al quale verrà conservato questo messaggio.
triggeredRules[]

object (TriggeredRule)

Solo output. Informazioni sulle regole che hanno causato la quarantena.
content

object (MessageContent)

Solo output. I contenuti e i metadati dettagliati dell'email in quarantena.
rawMessage

string (bytes format)

Solo output. L'intero messaggio email in una stringa formattata RFC 2822 e con codifica base64url. Restituisce questo valore se è selezionato il tipo di contenuti RAW.

Direzione

La direzione del messaggio.

Enum
DIRECTION_UNSPECIFIED Non specificato.
INBOUND Il messaggio in quarantena è stato ricevuto dall'utente.
OUTBOUND Il messaggio in quarantena è stato inviato dall'utente.

Stato

Lo stato di elaborazione attuale del messaggio.

Enum
STATE_UNSPECIFIED Non specificato.
PENDING_TRIAGE Il messaggio è in quarantena.
RELEASED Il messaggio è stato rilasciato dalla quarantena.
DENIED Il messaggio è stato rifiutato mentre era in quarantena.

TriggeredRule

Informazioni su una regola specifica che ha causato la messa in quarantena di un messaggio.

Rappresentazione JSON 
{
  "policyId": string,
  "ruleId": string,
  "displayName": string
}
Campi
policyId

string

L'ID della policy a cui è correlata la regola stabilita.
ruleId

string

L'ID della regola specifica stabilita.
displayName

string

Il nome o la descrizione della regola stabilita.

MessageContent

Informazioni dettagliate sui contenuti di un'email in quarantena.

Rappresentazione JSON 
{
  "headers": [
    {
      object (Header)
    }
  ],
  "attachments": [
    {
      object (Attachment)
    }
  ],
  "body": string,
  "subject": string,
  "labels": [
    string
  ],
  "classificationLabelValues": [
    {
      object (ClassificationLabelValue)
    }
  ]
}
Campi
headers[]

object (Header)

Le intestazioni dell'email.
attachments[]

object (Attachment)

Gli allegati trovati nell'email.
body

string

Il corpo o lo snippet in testo normale del messaggio email.
subject

string

L'oggetto dell'email.
labels[]

string

Etichette standard applicate al messaggio (ad es. "QUARANTENA").
classificationLabelValues[]

object (ClassificationLabelValue)

Valori delle etichette di classificazione applicati al messaggio. Presente solo per gli account Google Workspace.

Allegato

Un allegato all'interno di un'email.

Rappresentazione JSON 
{
  "filename": string,
  "mimeType": string,
  "sizeBytes": string,
  "attachmentId": string
}
Campi
filename

string

Il nome file dell'allegato.
mimeType

string

Il tipo MIME dell'allegato (ad es. "application/pdf").
sizeBytes

string (int64 format)

Le dimensioni dell'allegato in byte.
attachmentId

string

Un identificatore univoco utilizzato per recuperare i contenuti dell'allegato.

ClassificationLabelValue

Etichette di classificazione applicate all'email.

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

string

L'ID etichetta di classificazione alfanumerico non elaborato o canonico.
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

L'ID campo per il valore dell'etichetta di classificazione.
selection

string

ID della scelta di selezione per l'opzione di selezione.

Metodi

batchDeny

 Rifiuta un elenco di messaggi in modo asincrono.

batchRelease

 Rilascia un elenco di messaggi in modo asincrono.

deny

 Rifiuta un messaggio da una quarantena.

get

 Recupera i metadati e i contenuti di un messaggio in quarantena.

list

 Esegue query per i messaggi in quarantena utilizzando condizioni di filtro specifiche.

release

 Rilascia un messaggio dalla quarantena per recapitarlo ai destinatari.
Cerca i messaggi in quarantena utilizzando query di ricerca specifiche.