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. Beim customerId muss das Anfangsbuchstaben „C“ entfernt werden, z. B. 046psxkn. Es wird von der Anruferidentität abgeleitet, sofern nicht angegeben. Kundennummer ermitteln
pageSize

integer

Optional. Die angeforderte Seitengröße. Der Server gibt möglicherweise weniger Artikel zurück als angefordert. Ist kein Wert angegeben, 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. Sortierreihenfolge der Ergebnisse. Wenn nicht angegeben, können Ergebnisse in beliebiger Reihenfolge zurückgegeben werden. Mit orderBy="createTime desc" können Sie die Ergebnisse in absteigender Reihenfolge nach dem Zeitstempel der Erstellung sortieren. Aktuell werden die Sortierung nach createTime asc, createTime desc und updateTime desc unterstützt

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für eine Anfrage zur Eintragung 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 es möglicherweise weitere Benachrichtigungen gibt, die mit der Eintragsanfrage übereinstimmen. Dieser Wert kann in einem nachfolgenden ListAlertsRequest verwendet werden, um Benachrichtigungen vom letzten Ergebnis des aktuellen Listenaufrufs zu erhalten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.