Übersicht

Mit der Alert Center API können Sie Benachrichtigungen verwalten, die Ihre Domain betreffen. Eine Benachrichtigung ist eine Warnung vor einem potenziellen Sicherheitsproblem, das von Google erkannt wurde. Benachrichtigungen enthalten die folgenden Informationen:

  • Quelle der Benachrichtigung
  • Name der Benachrichtigung
  • Zeitpunkt, zu dem die Benachrichtigung erstellt wurde
  • Spezifische Daten, die mit dieser Benachrichtigung verknüpft sind

Domainadministratoren können Benachrichtigungen über die Admin-Konsole manuell aufrufen und verwalten. Mit der Alert Center API können von Ihnen erstellte Apps Daten und Feedback zu Benachrichtigungen abrufen. Die API kann auch neues Feedback für vorhandene Benachrichtigungen erstellen.

Eine Überwachungs-App kann z. B. mit der Alert Center API die neuesten Benachrichtigungen für eine Domain abrufen, diese priorisieren und dann Mitglieder Ihrer Organisation benachrichtigen. Nachdem Ihr Team auf die Benachrichtigung reagiert hat, könnte die App auf Grundlage der Ergebnisse Feedback zur Benachrichtigung hinzufügen.

Alert Center API verwenden

Bevor Sie die Alert Center API verwenden können, müssen Sie ein neues Google Cloud Projekt einrichten und die Alert Center API aktivieren. Ihr Projekt muss beim Zugriff auf die API ein Dienstkonto verwenden.

Sobald Ihre App ein Google Cloud-Projekt hat, das die Voraussetzungen erfüllt und ordnungsgemäß autorisiert ist, kann sie Alert Center API-REST-Anfragen stellen. Die Verwendung der verfügbaren Clientbibliotheken erleichtert das Stellen von API-Anfragen.

Das folgende Beispiel zeigt, wie Sie verfügbare Benachrichtigungen mit der API auflisten:

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