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 Centre d'alertes update settings 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.