Обзор

API Центра оповещений позволяет управлять оповещениями, затрагивающими ваш домен. Оповещение — это предупреждение о потенциальной проблеме безопасности, обнаруженной Google. Оповещения содержат следующую информацию:

  • Источник, из которого поступило оповещение.
  • Название оповещения.
  • Время срабатывания этого оповещения.
  • Конкретные данные, связанные с этим предупреждением.

Администраторы домена могут просматривать и управлять оповещениями вручную из консоли администратора Google . API Центра оповещений позволяет приложениям, которые вы создаете, получать данные об оповещениях и отзывы об оповещениях. API также может создавать новые отзывы об оповещениях для существующих оповещений.

Например, приложение для мониторинга может использовать API Центра оповещений для получения самых последних оповещений для домена, расставить приоритеты и затем уведомить членов вашей организации. После того, как ваша команда отреагирует на оповещение, приложение может добавить к нему отзыв, основанный на полученных данных.

Используйте API Центра оповещений

Перед использованием API Центра оповещений необходимо создать новый проект Google Cloud и включить API Центра оповещений . При доступе к API ваш проект должен использовать учетную запись службы .

После того как ваше приложение будет иметь проект Google Cloud, отвечающий предварительным требованиям и должным образом авторизованный , оно сможет отправлять REST-запросы к API Центра оповещений. Отправка API-запросов упрощается при использовании доступных клиентских библиотек .

В следующем примере показано, как получить список доступных оповещений с помощью API:

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