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, dem die Benachrichtigungen zugewiesen sind. Der Anfangsbuchstabe „C“ muss aus der customerId entfernt werden (z. B. 046psxkn). Wird aus der Identität des Anrufers abgeleitet, falls nicht angegeben. Kundennummer ermitteln
pageSize

integer

Optional. Die angeforderte Seitengröße. Der Server gibt möglicherweise weniger Elemente zurück, als angefordert. Wenn keine Angabe erfolgt, wählt der Server einen geeigneten Standardwert aus.
pageToken

string

Optional. Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. Ist der Wert leer, wird eine neue Iteration gestartet. Wenn Sie eine Iteration fortsetzen möchten, geben Sie den Wert aus dem Feld nextPageToken der vorherigen ListAlertsResponse ein.
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. Andernfalls werden die Ergebnisse in einer beliebigen Reihenfolge zurückgegeben. Mit orderBy="createTime desc" können Sie die Ergebnisse nach dem Erstellungszeitstempel in absteigender Reihenfolge sortieren. Derzeit werden die Sortierungen createTime asc, createTime desc und updateTime desc unterstützt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht auf eine Anfrage zum Eintrag einer Benachrichtigung.

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. Wenn dieses Feld nicht leer ist, gibt es möglicherweise weitere Benachrichtigungen, die mit der Listenanfrage übereinstimmen. Dieser Wert kann in einer nachfolgenden ListAlertsRequest verwendet werden, um Benachrichtigungen zu erhalten, die vom letzten Ergebnis des aktuellen Listenaufrufs fortgesetzt werden.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.