Benachrichtigungen

Die Alert Center API kann Benachrichtigungen senden, wenn Benachrichtigungen aktualisiert werden. Damit Sie Benachrichtigungen erhalten, müssen Sie Ihre Benachrichtigungseinstellungen konfigurieren.

Pub/Sub-Benachrichtigungen

Die Alert Center API kann Benachrichtigungen in einem Pub/Sub-Thema veröffentlichen. Nachdem Sie ein Thema erstellt und alerts-api-push-notifications@system.gserviceaccount.com die Berechtigung zum Veröffentlichen erteilt haben, legen Sie dieses Thema mit der Alert Center API Einstellung „Einstellungen aktualisieren“ API als Benachrichtigungsziel fest. 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.

Attribute von Pub/Sub-Nachrichten

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, beendet wurde.
  • alertcenter_type: Der Typ der Benachrichtigung. Eine Liste der verfügbaren Benachrichtigungstypen finden Sie unter Benachrichtigungstypen in Google Workspace.
  • alertcenter_source: Eine eindeutige Kennung für das System, das die Benachrichtigung gemeldet hat.
  • alertcenter_create_time: Die Uhrzeit, zu der diese Benachrichtigung erstellt wurde.
  • alertcenter_update_time: Die Uhrzeit, zu der diese Benachrichtigung zuletzt aktualisiert wurde.

Nutzlast der Nachricht

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 Benachrichtigungs typen. Das Format der Nutzlast hängt von alertcenter_payload_format ab. Wenn das Format "JSON" ist, ist die Nutzlast ein base64-codiertes JSON-Objekt.