Method: alerts.list

Wyświetla listę alertów.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
customerId

string

Opcjonalnie: Unikalny identyfikator konta Google Workspace klienta, z którym powiązane są alerty. W identyfikatorze customerId musi być pominięty początkowy ciąg „C” (np. 046psxkn). Jeśli nie jest podany, identyfikator jest wywnioskowany na podstawie tożsamości dzwoniącego. Znajdź identyfikator klienta.
pageSize

integer

Opcjonalnie: Żądany rozmiar strony. Serwer może zwrócić mniej elementów niż żądana liczba. Jeśli nie podasz wartości, serwer wybierze odpowiednią wartość domyślną.
pageToken

string

Opcjonalnie: Token identyfikujący stronę wyników, którą serwer powinien zwrócić. Jeśli jest puste, rozpoczyna się nowa iteracja. Aby kontynuować iterację, przekaż wartość z pola nextPageToken poprzedniej odpowiedzi ListAlertsResponse.
filter

string

Opcjonalnie: ciąg zapytania służący do filtrowania wyników alertów. Więcej informacji znajdziesz w artykułach Filtry zapytań i Obsługiwane pola filtra zapytania.
orderBy

string

Opcjonalnie: kolejność sortowania wyników na liście. Jeśli nie podasz tego argumentu, wyniki mogą być zwracane w dowolnej kolejności. Za pomocą opcji orderBy="createTime desc" możesz posortować wyniki w kolejności malejącej według sygnatury czasowej utworzenia. Obecnie obsługiwane są następujące opcje sortowania: createTime asc, createTime desc, updateTime desc

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na prośbę o wyświetlenie alertu.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string
}
Pola
alerts[]

object (Alert)

Lista alertów.
nextPageToken

string

Token następnej strony. Jeśli nie jest pusty, oznacza, że może być więcej alertów pasujących do żądania listy. Ta wartość może być używana w kolejnych wywołaniach ListAlertsRequest, aby otrzymywać alerty kontynuujące ostatni wynik bieżącego wywołania listy.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.