Przegląd

Interfejs Alert Center API umożliwia zarządzanie alertami dotyczącymi Twojej domeny. Alert to ostrzeżenie o potencjalnym problemie z bezpieczeństwem wykrytym przez Google. Alerty zawierają następujące informacje:

  • Źródło, z którego pochodzi alert.
  • Nazwa alertu.
  • Czas wystąpienia alertu.
  • Określone dane powiązane z tym alertem.

Administratorzy domeny mogą wyświetlać alerty i zarządzać nimi ręcznie w konsoli administracyjnej Google. Interfejs Alert Center API umożliwia aplikacjom tworzenie danych służących do pobierania danych z alertów i generowania opinii na ich temat. Interfejs API może też generować nowe informacje zwrotne dotyczące istniejących alertów.

Aplikacja do monitorowania może na przykład używać interfejsu Alert Center API do pobierania najnowszych alertów dla domeny, nadawania im priorytetów, a następnie powiadamiania członków organizacji. Gdy zespół odpowie na alert, aplikacja może dołączyć do niego opinię na podstawie wyników.

Używanie interfejsu Alert Center API

Aby korzystać z interfejsu Alert Center API, musisz skonfigurować nowy projekt Cloud Platform i włączyć interfejs Alert Center API. Podczas uzyskiwania dostępu do interfejsu API projekt musi korzystać z konta usługi.

Jeśli projekt Cloud Twojej aplikacji spełnia wymagania wstępne i zostanie poprawnie autoryzowany, będzie mogła wysyłać żądania REST interfejsu Alert Center API. Tworzenie żądań do interfejsu API jest łatwiejsze, gdy używasz dostępnych bibliotek klienta.

Z przykładu poniżej dowiesz się, jak wyświetlić listę dostępnych alertów za pomocą interfejsu API:

Java

// First, authorize the API and create a client to make requests with.
URL serviceAccountUrl = AuthUtils.class.getResource("/client_secret.json");
GoogleCredentials credentials =  ServiceAccountCredentials
    .fromStream(serviceAccountUrl.openStream())
    .createDelegated("admin@xxxx.com")
    .createScoped(Collections.singleton("https://www.googleapis.com/auth/apps.alerts"));
ApacheHttpTransport transport = new ApacheHttpTransport();
HttpCredentialsAdapter adapter = new HttpCredentialsAdapter(credentials);
AlertCenter alertCenter = new AlertCenter.Builder(transport, new JacksonFactory(), adapter)
    .setApplicationName("Alert Center client")
    .build();

// List alerts in pages, printing each alert discovered.
String pageToken = null;
do {
  ListAlertsResponse listResponse = service.alerts().list().setPageToken(pageToken)
      .setPageSize(20).execute();
  if (listResponse.getAlerts() != null) {
    for (Alert alert : listResponse.getAlerts()) {
      System.out.println(alert);
    }
  }
  pageToken = listResponse.getNextPageToken();
} while (pageToken != null);