Przegląd

Interfejs Alert Center API umożliwia zarządzanie alertami dotyczącymi 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.
  • Określone dane powiązane z tym alertem.

Administratorzy domeny mogą ręcznie wyświetlać alerty i zarządzać nimi na Konsola administracyjna Google. Interfejs Alert Center API pozwala utworzonym przez Ciebie aplikacjom pobierać dane alertów i opinie 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 najnowsze alerty w domenie, nadaj im priorytety, a następnie powiadom użytkowników Twojej organizacji. Gdy zespół zareaguje na alert, aplikacja będzie mogła dołączyć do alertu opinie na podstawie uzyskanych wniosków.

Użyj interfejsu Alert Center API

Zanim użyjesz interfejsu Alert Center API, musisz skonfigurować: nowy projekt Cloud Platform i włącz interfejs Alert Center API. Twój projekt musi korzystać z konta usługi podczas korzystania z interfejsu API.

Gdy aplikacja będzie miała projekt Cloud, który spełnia wymagania wstępne i jest prawidłowo Authorized, może spowodować, że Żądania REST interfejsu Alert Center API. 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);