您可以透過 Pub/Sub 通知接收新註冊裝置、裝置報告和最近發出的指令相關快訊。
如要設定 Pub/Sub 通知，請啟用 Pub/Sub API 並建立主題。如要接收發布至某項主題的訊息，請為該主題建立訂閱項目。訂閱項目會將主題連結至訂閱者應用程式，以便接收及處理發布至主題的訊息。建立訂閱項目後，您必須授予 Android Device Policy 權限，才能發布至主題。
1. 為專案啟用 Pub/Sub API
如需如何啟用 Pub/Sub API 的操作說明，請參閱管理中心快速入門指南。請務必選取已啟用 Android Management API 的專案。
2. 建立主題
啟用 API 後，您需要建立主題，讓 Android Device Policy 可以發布通知。建立主題的方法有兩種：
a. 在 Google Cloud 控制台中手動操作。
b. 使用 Pub/Sub API (請參閱建立主題方法)。
建立主題後，請記下主題名稱。
3. 建立訂閱項目
訂閱項目會擷取發布至指定主題的訊息串。建立訂閱項目有兩種方式：
a. 在 Google Cloud 控制台中手動操作。
b. 使用 Pub/Sub API (請參閱建立訂閱項目方法)。
4. 授予 Android Device Policy 發布至主題的權限
您必須授予 android-cloud-policy@system.gserviceaccount.com 發布至主題的權限。授予發布權限的方式有兩種：
a. 在 Google Cloud 控制台中手動建立。
- 將 android-cloud-policy@system.gserviceaccount.com 新增為主題成員。
- 依序點選「選取角色」 >「Pub/Sub」 >「Pub/Sub 發布者」。
b. 使用 Pub/Sub API (請參閱透過 IAM API 控管存取權)
- 將
serviceAccount:android-cloud-policy@system.gserviceaccount.com新增至members。 - 將
role設為roles/pubsub.publisher。
5. 更新企業版，以便支援通知
如要支援的通知一律支援 ENTERPRISE_UPGRADE，請略過這個步驟。
如要將企業的通知連結至您建立的主題，請呼叫 enterprises.patch，並指定下列參數：
pubsubTopic：Pub/Sub 主題的名稱，格式為projects/{project}/topics/{topic}。enabledNotificationTypes：包含所有要接收的通知類型。
6. 使用 Pub/Sub API 接收通知
訂閱可以針對訊息傳送使用推送或提取機制。如需透過這兩種機制接收通知的指南和操作說明，請參閱 Pub/Sub 訂閱端指南。
訊息格式
訊息會以 PubsubMessage 的形式傳送。訊息的 attributes 欄位包含屬性，金鑰為 notificationType，值則設為觸發訊息的通知類型 (例如 ENROLLMENT)。訊息的 data 欄位包含已更新資源的 JSON 表示法，並編碼為 UTF-8 字串。通知和對應的資源類型如下：
COMMAND通知使用 Operation 資源類型。USAGE_LOGS通知使用 UsageLogEvent 資源類型。ENROLLMENT和STATUS_REPORT通知使用「裝置」資源類型。ENTERPRISE_UPGRADE通知使用資源類型「EnterpriseUpgradeEvent」EnterpriseUpgradeEvent。
在 Enterprise 上設定 pubsubTopic 時，系統會發布初始訊息，並將 notificationType 設為 test。這則訊息是用來驗證 Android Device Policy 是否具備主題的發布權限，請忽略這則訊息。
預期延遲時間
系統應立即傳送企業升級事件。
如果本機裝置事件接連發生，系統會將這些事件批次處理，並透過單一 Pub/Sub 訊息回報給 EMM。
| 活動類型 | 裝置端事件與相應 EMM 通知之間的預期延遲時間1 |
|---|---|
| 高優先順序鍵控應用程式狀態 | 立即，每分鐘最多一份報告 |
| 標準優先順序鍵控應用程式狀態 | 1 分鐘內 |
| 在佈建期間發生的應用程式相關事件，適用於 IT 管理員2定義安裝狀態的應用程式 | 在其他相關佈建事件發生後的一分鐘內 |
| 佈建後與應用程式相關的事件，適用於 IT 管理員定義安裝狀態的應用程式。 | 5 分鐘內 |
| 應用程式相關事件 (佈建期間和之後)，適用於員工定義安裝狀態的應用程式3 | 60 分鐘內 |
| 其他裝置端應用程式事件 | 60 分鐘內 |
-
根據受控情況盡力達成目標。實際延遲時間可能會因裝置和環境因素而異。 ↩
-
InstallType政策中強制執行的應用程式：FORCE_INSTALLED、BLOCKED、REQUIRED_FOR_SETUP、PREINSTALLED和KIOSK。 ↩ -
InstallType可用應用程式：AVAILABLE、INSTALL_TYPE_UNSPECIFIED。 ↩