La API del Centro de alertas puede enviar notificaciones cuando se actualizan las alertas. Para recibir notificaciones, debes configurar los parámetros de configuración de las notificaciones.
Notificaciones de Pub/Sub
La API del Centro de alertas puede publicar notificaciones en un tema de Pub/Sub. Después de crear un tema y otorgar permiso de publicación de alerts-api-push-notifications@system.gserviceaccount.com, usa la API de configuración de actualización de la API del Centro de alertas para establecer ese tema como destino de notificación. Una vez configurada, la API del Centro de alertas 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: Es el tipo de recurso. El valor admitido es"ALERT".alertcenter_resource_status: Es el estado del recurso. Los valores admitidos son"CREATED","DELETED","UNDELETED"y"MODIFIED".alertcenter_payload_format: Es el formato de la carga útil. El valor admitido es"JSON".
Atributos de alerta
alertcenter_start_time: Es la fecha y hora en que se inició o detectó el evento que causó esta alerta.alertcenter_end_time: Es la fecha y hora en que dejó de estar activo el evento que causó esta alerta.alertcenter_type: Es el tipo de alerta. Para obtener una lista de los tipos de alertas disponibles, consulta Tipos de alertas de Google Workspace.alertcenter_source: Es un identificador único para el sistema que informó la alerta.alertcenter_create_time: Es la fecha y hora en que se creó esta alerta.alertcenter_update_time: Es 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.