Notificaciones

La API de Alert Center puede enviar notificaciones cuando se actualizan las alertas. Para recibirlas, debes configurar los parámetros de configuración de las notificaciones.

Notificaciones de Pub/Sub

La API de Alert Center puede publicar notificaciones en un tema de Pub/Sub. Después de crear un tema y otorgar alerts-api-push-notifications@system.gserviceaccount.com permiso de publicación, usa la API de Alert Center update settings API para establecer ese tema como destino de notificación. Una vez configurada, la API de Alert Center publica un mensaje en ese tema para cada actualización, por ejemplo, cuando llega una alerta nueva.

Atributos de mensajes de Pub/Sub

En las siguientes secciones, se describen los atributos incluidos en los mensajes de Pub/Sub.

Atributos comunes

  • alertcenter_resource_type: El tipo de recurso. El valor admitido es "ALERT".
  • alertcenter_resource_status: El estado del recurso. Los valores admitidos son "CREATED", "DELETED", "UNDELETED" y "MODIFIED".
  • alertcenter_payload_format: El formato de la carga útil. El valor admitido es "JSON".

Atributos de alerta

  • alertcenter_start_time: La hora en que se inició o detectó el evento que causó esta alerta.
  • alertcenter_end_time: La hora en que el evento que causó esta alerta dejó de estar activo.
  • alertcenter_type: El tipo de alerta. Para obtener una lista de los tipos de alertas disponibles, consulta Tipos de alertas de Google Workspace.
  • alertcenter_source: Un identificador único para el sistema que informó la alerta.
  • alertcenter_create_time: La hora en que se creó esta alerta.
  • alertcenter_update_time: La última vez que se actualizó esta alerta.

Carga útil del mensaje

La carga útil del mensaje depende de alertcenter_resource_type. Cuando el tipo de recurso es "ALERT", la carga útil es uno de los tipos de alerta de la API de Alert Center. El formato de la carga útil depende de alertcenter_payload_format. Cuando el formato es "JSON", la carga útil es un objeto JSON codificado en base64.