Обзор

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