Übersicht

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Mit der Alert Center API lassen sich Warnungen für Ihre Domain verwalten. Eine Benachrichtigung ist eine Warnung zu einem potenziellen Sicherheitsproblem, das Google erkannt hat. Benachrichtigungen enthalten die folgenden Informationen:

  • Quelle, von der die Benachrichtigung stammt.
  • Name der Benachrichtigung.
  • Zeitpunkt der Benachrichtigung.
  • Spezifische Daten, die mit dieser Benachrichtigung verknüpft sind.

Domainadministratoren können Benachrichtigungen in der Admin-Konsole manuell sehen und verwalten. Mit der Alert Center API können von Ihnen erstellte Apps Benachrichtigungsdaten abrufen und Feedback geben. Die API kann auch neues Feedback für vorhandene Benachrichtigungen erstellen.

Eine Monitoring-App könnte beispielsweise die Alert Center API verwenden, um die neuesten Benachrichtigungen für eine Domain abzurufen, sie zu priorisieren und Mitglieder Ihrer Organisation dann zu benachrichtigen. Nachdem Ihr Team auf die Benachrichtigung reagiert hat, kann die Anwendung auf Grundlage der Ergebnisse Feedback an die Benachrichtigung anhängen.

Alert Center API verwenden

Bevor Sie die Alert Center API verwenden, müssen Sie ein neues Cloud Platform-Projekt einrichten und die Alert Center API aktivieren. Für den Zugriff auf die API muss Ihr Projekt ein Dienstkonto verwenden.

Sobald Ihre Anwendung ein Cloud-Projekt hat, das die Voraussetzungen erfüllt und ordnungsgemäß autorisiert wurde, kann sie API-REST-Anfragen an die Benachrichtigungszentrale senden. Mit den verfügbaren Clientbibliotheken sind API-Anfragen einfacher.

Das folgende Beispiel zeigt, wie Sie verfügbare Benachrichtigungen mithilfe 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);