Descripción general

La API de Alert Center 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 que ocurrió esta alerta.
  • Datos específicos asociados con esta alerta.

Los administradores de dominio pueden ver y administrar las alertas manualmente desde el Consola del administrador de Google. El La API de Alert Center permite que las apps que compiles recuperen datos y comentarios sobre alertas. El La API también puede crear nuevos comentarios sobre alertas existentes.

Por ejemplo, una aplicación de supervisión puede usar la API de Alert Center para recuperar la las alertas más recientes de un dominio, priorizarlas y, luego, notificar a los miembros de tu organización. Después de que tu equipo responda a la alerta, la app podría adjuntar comentarios a la alerta en función de sus hallazgos.

Usa la API de Alert Center

Antes de usar la API de Alert Center, debes configurar un nuevo proyecto de Cloud Platform y habilitar la API de Alert Center. Tu proyecto debe usar una cuenta de servicio. cuando accedas a la API.

Cuando tu app tenga un proyecto de Cloud que cumpla con los requisitos previos autorizado, puede Solicitudes de REST de la API de Alert Center Realizar solicitudes a la API es más fácil cuando se usa el las bibliotecas cliente disponibles.

En el siguiente ejemplo, se muestra cómo generar una lista de las alertas disponibles usando 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);