Method: customers.quarantinedMessages.list

Fragt nach Nachrichten in Quarantäne mit bestimmten Filterbedingungen ab.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die übergeordnete Ressource, die diese Sammlung von Nachrichten besitzt. Format: customers/{customer_id}

Suchparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl der Elemente, die zurückgegeben werden sollen.
pageToken

string

Optional. Der Wert „nextPageToken“ wurde von einer vorherigen Listenanfrage zurückgegeben.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für [quarantinedMessages.list][].

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "quarantinedMessages": [
    {
      object (QuarantinedMessage)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Felder
quarantinedMessages[]

object (QuarantinedMessage)

Die Liste der Nachrichten in Quarantäne, die der Anfrage entsprechen.
nextPageToken

string

Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann.
unreachable[]

string

Konten, für die der Dienst keine in Quarantäne verschobenen Nachrichten abrufen konnte.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.