Descripción general

La API del Centro de alertas te permite administrar las alertas que afectan a tu dominio. Una alerta es una advertencia sobre un posible problema de seguridad que Google detectó. Las alertas incluyen la siguiente información:

  • Fuente de la que se originó la alerta.
  • Nombre de la alerta.
  • Hora en la que ocurrió esta alerta.
  • Datos específicos asociados con esta alerta.

Los administradores de dominio pueden ver y administrar alertas de forma manual desde la Consola del administrador de Google. La API del Centro de alertas te permite que las apps compiles recuperen datos y comentarios de alertas. La API también puede crear nuevos comentarios de alertas para las alertas existentes.

Por ejemplo, una app de supervisión podría usar la API del Centro de alertas para recuperar las alertas más recientes de un dominio, priorizarlas y, luego, notificar a los miembros de tu organización. Una vez que tu equipo haya respondido a la alerta, la app podría adjuntar comentarios en función de sus hallazgos.

Usar la API de Alert Center

Antes de usar la API del Centro de alertas, debes configurar un proyecto nuevo de Cloud Platform y habilitar la API del Centro de alertas. Tu proyecto debe usar una cuenta de servicio cuando acceda a la API.

Una vez que la app tenga un proyecto de Cloud que cumpla con los requisitos previos y esté autorizado de forma adecuada, puede realizar solicitudes de REST a la API de Alert Center. Es más fácil realizar solicitudes a la API cuando se usan las bibliotecas cliente disponibles.

En el siguiente ejemplo, se muestra cómo enumerar las alertas disponibles con la 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);