通知

快訊中心 API 可在快訊更新時傳送通知。如要接收通知，請設定通知設定。

Pub/Sub 通知

Alert Center API 可將通知發布至 Pub/Sub 主題。建立主題並授予 alerts-api-push-notifications@system.gserviceaccount.com 發布權限後，請使用 Alert Center API update settings API，將該主題設為通知目的地。設定完成後，Alert Center API 會在每次更新時 (例如收到新快訊時)，向該主題發布訊息。

Pub/Sub 訊息屬性

以下各節說明 Pub/Sub 訊息包含的屬性。

常見屬性

  • alertcenter_resource_type：資源類型。支援的值為 "ALERT"。
  • alertcenter_resource_status：資源的狀態。支援的值為 "CREATED"、"DELETED"、"UNDELETED" 和 "MODIFIED"。
  • alertcenter_payload_format：酬載格式。支援的值為 "JSON"。

快訊屬性

  • alertcenter_start_time：導致這項快訊的事件開始或偵測到的時間。
  • alertcenter_end_time：導致這項快訊的事件停止活動的時間。
  • alertcenter_type：快訊類型。如需可用的快訊類型清單，請參閱「Google Workspace 快訊類型」。
  • alertcenter_source：回報快訊的系統專屬 ID。
  • alertcenter_create_time：建立這則快訊的時間。
  • alertcenter_update_time：上次更新這則快訊的時間。

訊息酬載

訊息的酬載取決於 alertcenter_resource_type。如果資源類型為 "ALERT"，酬載就是 Alert Center API 快訊類型之一。酬載的格式取決於 alertcenter_payload_format。如果格式為 "JSON"，酬載會是 base64 編碼的 JSON 物件。