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ą te informacje:

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

Administratorzy domen mogą ręcznie wyświetlać alerty i zarządzać nimi w konsoli administracyjnej Google. Interfejs Alert Center API umożliwia tworzonym przez Ciebie aplikacjom pobieranie danych alertów i informacji zwrotnych na ich temat. Interfejs API może też generować nowe informacje zwrotne dotyczące istniejących alertów.

Na przykład aplikacja do monitorowania może używać interfejsu Alert Center API do pobierania najnowszych alertów dotyczących domeny, nadawania im priorytetów i powiadamiania osób w organizacji. Gdy zespół odpowie na alert, aplikacja może następnie dołączyć do niego informacje zwrotne na podstawie ustaleń.

Korzystanie z interfejsu Alert Center API

Zanim zaczniesz korzystać z interfejsu Alert Center API, musisz utworzyć nowy projekt Google Cloud i włączyć interfejs Alert Center API. Projekt musi używać konta usługi, aby uzyskać dostęp do interfejsu API.

Gdy aplikacja będzie mieć projekt w chmurze Google Cloud, który spełnia wymagania wstępne i jest odpowiednio autoryzowany, będzie mogła wysyłać żądania REST interfejsu Alert Center API. Wysyłanie żądań do interfejsu API jest łatwiejsze, gdy korzystasz z dostępnych bibliotek klientów.

Przykład poniżej pokazuje, jak za pomocą interfejsu API wyświetlić listę dostępnych alertów:

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);