API Центра оповещений позволяет управлять оповещениями, влияющими на ваш домен. Оповещение — это предупреждение о потенциальной проблеме безопасности, обнаруженной Google. Оповещения содержат следующую информацию:
- Источник, из которого поступило оповещение.
- Название оповещения.
- Время срабатывания этого оповещения.
- Конкретные данные, связанные с этим оповещением.
Администраторы домена могут просматривать оповещения и управлять ими вручную через консоль администратора Google . API Центра оповещений позволяет создаваемым приложениям получать данные оповещений и получать обратную связь. API также позволяет создавать новые обратные связи для существующих оповещений.
Например, приложение для мониторинга может использовать API Центра оповещений для получения последних оповещений по домену, приоритизации их и последующего оповещения сотрудников вашей организации. После того, как ваша команда отреагирует на оповещение, приложение может добавить к нему обратную связь на основе своих выводов.
Использовать API Центра оповещений
Перед использованием API Центра оповещений необходимо настроить новый проект Cloud Platform и включить API Центра оповещений . Для доступа к API ваш проект должен использовать учетную запись службы .
После того, как ваше приложение создаст облачный проект, соответствующий всем предварительным требованиям и прошедший надлежащую авторизацию , оно сможет отправлять REST-запросы к API Центра оповещений. Выполнять запросы к API становится проще при использовании доступных клиентских библиотек .
В следующем примере показано, как составить список доступных оповещений с помощью API:
Ява
// 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);