Benachrichtigungen

Ü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.