Mit der Alert Center API können Sie Benachrichtigungen verwalten, die Ihre Domain betreffen. Eine Warnung ist eine Warnung zu einem potenziellen Sicherheitsproblem, das von Google erkannt wurde. Benachrichtigungen enthalten die folgenden Informationen:
- Quelle, von der die Benachrichtigung stammt.
- Name der Benachrichtigung.
- Zeitpunkt der Benachrichtigung.
- Spezifische Daten, die dieser Warnung zugeordnet sind.
Domainadministratoren können Benachrichtigungen in der Admin-Konsole manuell aufrufen und verwalten. Mit der Alert Center API können von Ihnen erstellte Anwendungen Benachrichtigungsdaten abrufen und Feedback geben. Die API kann auch neues Feedback für vorhandene Benachrichtigungen erstellen.
Beispielsweise könnte eine Monitoring-App die Alert Center API verwenden, um die neuesten Benachrichtigungen für eine Domain abzurufen, sie zu priorisieren und die 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 können, müssen Sie ein neues Cloud Platform-Projekt einrichten und die Alert Center API aktivieren. Ihr Projekt muss für den Zugriff auf die API ein Dienstkonto verwenden.
Sobald Ihre Anwendung ein Cloud-Projekt hat, das die Voraussetzungen erfüllt und ordnungsgemäß autorisiert ist, kann sie REST API-Anfragen an die Alert Center API senden. Mit den verfügbaren Clientbibliotheken ist das API-Anfragen einfacher.
Das folgende Beispiel zeigt, wie Sie die verfügbaren 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);