Обзор

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

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

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

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

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

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