Обзор

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

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

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

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

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

Прежде чем использовать API Alert Center, вам необходимо настроить новый проект Cloud Platform и включить API Alert Center . Ваш проект должен использовать сервисную учетную запись при доступе к 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);