Method: alerts.list

Listet die Benachrichtigungen auf.

HTTP-Anfrage

GET https://alertcenter.googleapis.com/v1beta1/alerts

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
customerId

string

Optional. Die eindeutige Kennung des Google Workspace-Kontos des Kunden, mit dem die Benachrichtigungen verknüpft sind. customerId muss das erste „C“ haben entfernt werden (z. B. 046psxkn). Von der Anruferidentität abgeleitet, falls nicht angegeben Kundennummer ermitteln
pageSize

integer

Optional. Die angeforderte Seitengröße. Der Server gibt möglicherweise weniger Artikel als angefordert zurück. Wenn kein Wert angegeben ist, wählt der Server einen geeigneten Standardwert aus.
pageToken

string

Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. Wenn das Feld leer ist, wird eine neue Iteration gestartet. Übergeben Sie den Wert aus dem Feld nextPageToken der vorherigen ListAlertsResponse, um eine Iteration fortzusetzen.
filter

string

Optional. Ein Abfragestring zum Filtern von Benachrichtigungsergebnissen. Weitere Informationen finden Sie unter Abfragefilter und Unterstützte Abfragefilterfelder.
orderBy

string

Optional. Die Sortierreihenfolge der Listenergebnisse. Wenn nicht angegeben, können die Ergebnisse in beliebiger Reihenfolge zurückgegeben werden. Sie können die Ergebnisse mit orderBy="createTime desc" basierend auf dem Erstellungszeitstempel in absteigender Reihenfolge sortieren. Derzeit werden folgende Sortierungen unterstützt: createTime asc, createTime desc, updateTime desc

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für eine Anfrage zum Auflisten von Benachrichtigungen.

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

JSON-Darstellung 
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string
}
Felder
alerts[]

object (Alert)

Die Liste der Benachrichtigungen.
nextPageToken

string

Das Token für die nächste Seite. Falls nicht leer, bedeutet das, dass möglicherweise weitere Benachrichtigungen vorhanden sind, die mit der Eintragsanfrage übereinstimmen. Dieser Wert kann in einem nachfolgenden ListAlertsRequest verwendet werden, um Benachrichtigungen zu erhalten, die vom letzten Ergebnis des aktuellen Listenaufrufs an fortgesetzt werden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/apps.alerts

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.