Mit der Alert Center API können Sie Benachrichtigungen verwalten, die sich auf Ihre Domain auswirken. Eine Warnung ist eine Warnung vor einem potenziellen Sicherheitsproblem, das Google entdeckt hat. Benachrichtigungen enthalten die folgenden Informationen:
- Quelle, von der die Benachrichtigung stammt.
- Name der Benachrichtigung.
- Zeitpunkt, zu dem diese Warnung aufgetreten ist.
- Spezifische Daten im Zusammenhang mit dieser Benachrichtigung.
Domain-Administratoren können Warnungen manuell über die Admin-Konsole: Die Mit der Alert Center API können von Ihnen erstellte Apps Benachrichtigungsdaten und Feedback zu Benachrichtigungen abrufen. Die Die API kann auch neues Feedback-Feedback für vorhandene Benachrichtigungen erstellen.
Eine Überwachungs-App könnte z. B. die Alert Center API verwenden, um das Ereignis die neuesten Benachrichtigungen für eine Domain, priorisieren Sie sie und benachrichtigen Sie dann die Mitglieder Ihrer Organisation. Nachdem Ihr Team auf die Benachrichtigung reagiert hat, kann die App basierend auf den Ergebnissen Feedback zur Benachrichtigung anhängen.
Alert Center API verwenden
Bevor Sie die Alert Center API verwenden können, müssen Sie ein neues Cloud Platform-Projekt erstellen und die Alert Center API aktivieren. Ihr Projekt muss ein Dienstkonto verwenden beim Zugriff auf die API.
Sobald Ihre Anwendung ein Cloud-Projekt hat, das die Voraussetzungen erfüllt und ordnungsgemäß autorisiert ist, kann es REST-Anfragen der Alert Center API. Das Senden von API-Anfragen ist einfacher, wenn Sie die verfügbaren Clientbibliotheken.
Das folgende Beispiel zeigt, wie die verfügbaren Benachrichtigungen mithilfe der API aufgelistet werden:
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);