Über die Alert Center API können Benachrichtigungen gesendet werden, wenn Benachrichtigungen aktualisiert werden. Damit Sie Benachrichtigungen erhalten, müssen Sie Ihre Benachrichtigungseinstellungen konfigurieren.
Pub/Sub-Benachrichtigungen
Mit der Alert Center API können Benachrichtigungen in einem Pub/Sub-Thema veröffentlicht werden. Nachdem Sie ein Thema erstellt und alerts-api-push-notifications@system.gserviceaccount.com die Berechtigung zum Veröffentlichen erteilt haben, verwenden Sie die Alert Center API update settings API, um dieses Thema als Benachrichtigungsziel festzulegen. Nach der Konfiguration veröffentlicht die Alert Center API für jede Aktualisierung eine Nachricht in diesem Thema, z. B. wenn eine neue Benachrichtigung eingeht.
Pub/Sub-Nachrichtenattribute
In den folgenden Abschnitten werden die Attribute beschrieben, die in den Pub/Sub-Nachrichten enthalten sind.
Allgemeine Attribute
alertcenter_resource_type: Der Typ der Ressource. Der unterstützte Wert ist"ALERT".alertcenter_resource_status: Der Status der Ressource. Unterstützte Werte sind"CREATED","DELETED","UNDELETED"und"MODIFIED".alertcenter_payload_format: Das Format der Nutzlast. Der unterstützte Wert ist"JSON".
Benachrichtigungsattribute
alertcenter_start_time: Die Uhrzeit, zu der das Ereignis, das diese Benachrichtigung ausgelöst hat, gestartet oder erkannt wurde.alertcenter_end_time: Die Uhrzeit, zu der das Ereignis, das diese Benachrichtigung ausgelöst hat, nicht mehr aktiv war.alertcenter_type: Der Typ der Benachrichtigung. Eine Liste der verfügbaren Benachrichtigungstypen finden Sie unter Google Workspace-Benachrichtigungstypen.alertcenter_source: Eine eindeutige Kennung für das System, das die Benachrichtigung gemeldet hat.alertcenter_create_time: Der Zeitpunkt, zu dem diese Benachrichtigung erstellt wurde.alertcenter_update_time: Der Zeitpunkt der letzten Aktualisierung dieser Benachrichtigung.
Nachrichtennutzlast
Die Nutzlast der Nachricht hängt von alertcenter_resource_type ab. Wenn der Ressourcentyp "ALERT" ist, ist die Nutzlast einer der Benachrichtigungstypen der Alert Center API. Das Format der Nutzlast hängt von alertcenter_payload_format ab. Wenn das Format "JSON" ist, ist die Nutzlast ein base64-codiertes
JSON-Objekt.