L'API Centre d'alerte peut envoyer des notifications lorsque des alertes sont mises à jour. Pour recevoir des notifications, vous devez configurer vos paramètres de notification.
Notifications Pub/Sub
L'API Centre d'alertes peut publier des notifications dans un sujet Pub/Sub. Après avoir créé un sujet et accordé l'autorisation de publication alerts-api-push-notifications@system.gserviceaccount.com, utilisez l'API update settings de l'API Alert Center pour définir ce sujet comme destination des notifications. Une fois configurée, l'API du Centre d'alertes publie un message dans ce thème pour chaque mise à jour, par exemple lorsqu'une nouvelle alerte arrive.
Attributs des messages Pub/Sub
Les sections suivantes décrivent les attributs inclus dans les messages Pub/Sub.
Attributs communs
alertcenter_resource_type: type de la ressource. La valeur acceptée est"ALERT".alertcenter_resource_status: état de la ressource. Les valeurs acceptées sont"CREATED","DELETED","UNDELETED"et"MODIFIED".alertcenter_payload_format: format de la charge utile. La valeur acceptée est"JSON".
Attributs d'alerte
alertcenter_start_time: heure à laquelle l'événement ayant déclenché cette alerte a commencé ou a été détecté.alertcenter_end_time: heure à laquelle l'événement ayant déclenché cette alerte a cessé d'être actif.alertcenter_type: type de l'alerte. Pour obtenir la liste des types d'alertes disponibles, consultez Types d'alertes Google Workspace.alertcenter_source: identifiant unique du système qui a signalé l'alerte.alertcenter_create_time: heure à laquelle cette alerte a été créée.alertcenter_update_time: date de la dernière mise à jour de cette alerte.
Charge utile du message
La charge utile du message dépend de alertcenter_resource_type. Lorsque le type de ressource est "ALERT", la charge utile correspond à l'un des types d'alertes de l'API Alert Center. Le format de la charge utile dépend de alertcenter_payload_format. Lorsque le format est "JSON", la charge utile est un objet JSON encodé en base64.