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ątkowe znaki „C” (np. 046psxkn). Wniosek jest określany na podstawie nazwy rozmówcy. Znajdowanie swojego identyfikatora klienta

pageSize

integer

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

pageToken

string

Opcjonalnie. Token określający stronę wyników, która powinna zostać zwrócona przez serwer. Jeśli to pole jest puste, rozpoczyna się nowa iteracja. Aby kontynuować iterację, przekaż wartość z poprzedniego pola nextPageTokenAlertAlertsResponse.

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 nie określono wyników, mogą być one zwracane w losowym czasie. Możesz posortować wyniki w kolejności malejącej według sygnatury czasowej utworzenia za pomocą orderBy="createTime desc". Obecnie obsługiwane jest sortowanie według: createTime asc, createTime desc, updateTime desc

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na prośbę o utworzenie 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 pole jest puste, może być więcej alertów pasujących do żądania wizytówki. Ta wartość może zostać użyta w następnych ListAlertsRequest, aby otrzymywać alerty dotyczące 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 po autoryzacji.