Method: customers.quarantinedMessages.list

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

Richiesta HTTP

GET https://mailadminquarantine.googleapis.com/v1/{parent=customers/*}/quarantinedMessages

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di percorso

Parametri
parent

string

Obbligatorio. La risorsa padre, proprietaria di questa raccolta di messaggi. Formato: customers/{customer_id}

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di elementi da restituire.

pageToken

string

Facoltativo. Il valore nextPageToken restituito da una richiesta List precedente.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per [quarantinedMessages.list][].

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "quarantinedMessages": [
    {
      object (QuarantinedMessage)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campi
quarantinedMessages[]

object (QuarantinedMessage)

L'elenco dei messaggi in quarantena che corrispondono alla richiesta.

nextPageToken

string

Un token per recuperare la pagina successiva dei risultati.

unreachable[]

string

Account per i quali il servizio non è riuscito a recuperare i messaggi in quarantena.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/gmail.admin.quarantine
  • https://www.googleapis.com/auth/gmail.admin.quarantine.readonly

Per saperne di più, consulta la guida all'autorizzazione.