Opis

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

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

Administratorzy domeny mogą ręcznie wyświetlać alerty i zarządzać nimi w konsoli administracyjnej Google. Interfejs Alert Center API umożliwia aplikacjom pobieranie danych alertów i przesyłanie opinii na ich temat. Interfejs API może też tworzyć 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 skonfigurować nowy projekt Cloud Platform i włączyć interfejs Alert Center API. Twój projekt musi korzystać z konta usługi podczas uzyskiwania dostępu do interfejsu API.

Gdy aplikacja ma projekt Cloud zgodny z wymaganiami wstępnymi i prawidłowo autoryzowany, może wysyłać żądania REST API API z Alert Center. Wysyłanie żądań do interfejsu API jest łatwiejsze, gdy używasz dostępnych bibliotek klienta.

Poniższy przykład pokazuje, 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);