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 są powiązane alerty. customerId musi mieć początkowy znak „C” bez tekstu (np. 046psxkn). Wartość wywnioskowana na podstawie tożsamości rozmówcy, jeśli nie została podana. Znajdowanie swojego identyfikatora klienta
pageSize

integer

Opcjonalnie: Żądany rozmiar strony. Serwer może zwrócić mniej elementów niż zażądano. Jeśli wartość nie została określona, serwer wybiera odpowiednią wartość domyślną.
pageToken

string

Opcjonalnie: Token identyfikujący stronę wyników, którą serwer powinien zwrócić. Jeśli pole jest puste, rozpoczyna się nowa iteracja. Aby kontynuować iterację, przekaż wartość z pola nextPageToken poprzedniego pola 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 filtrów zapytań.
orderBy

string

Opcjonalnie: Kolejność sortowania wyników na liście. Jeśli wyniki nie zostaną podane, mogą być zwracane w dowolnej kolejności. Za pomocą funkcji orderBy="createTime desc" możesz posortować wyniki w kolejności malejącej według sygnatury czasowej utworzenia. Obecnie obsługiwane sortowanie to createTime asc, createTime desc, updateTime desc

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat z odpowiedzią na prośbę o utworzenie listy alertów.

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 pole nie jest puste, wskazuje, że może być więcej alertów pasujących do żądania wyświetlenia informacji. można użyć tej wartości w kolejnym ListAlertsRequest, aby otrzymywać alerty z ostatniego wyniku 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 na temat autoryzacji.