設定 EMM 通知

Google Play 會針對影響企業的各種事件產生通知,這類通知稱為「EMM 通知」。舉例來說,當應用程式獲得核准時,系統會傳送 ProductApprovalEvent 通知。

EMM 通知會與特定企業服務帳戶 (ESA)相關聯。身為 EMM,您可以設定控制台,讓系統根據收到的通知,向企業 IT 管理員顯示警報或訊息。

使用 Google Cloud Pub/Sub 傳送 EMM 通知。如要進一步瞭解如何設定 Pub/Sub 通知,請參閱訂閱者總覽提取訂閱者指南

如要確認系統已成功設定為接收 Google Play 的 EMM 通知,並擷取需要連結訂閱項目的 Cloud Pub/Sub 主題名稱,請呼叫 Enterprises.sendTestPushNotification

傳送測試通知,即可驗證企業行動管理服務與 Google Cloud Pub/Sub 服務的整合情形。如果 EMM 通知設定正確,API 會傳回以下內容:

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

拉取通知

Google Cloud Pub/Sub 支援兩種不同的通知機制:提取和推送。不過,我們建議您只使用拉取通知。使用提取方法不需要設定任何外部伺服器,且可搭配以程式設計方式建立的 ESA 和手動建立的 ESA 使用。提取通知的另一個優點是,客戶幾乎不需要額外設定或維護。請使用 Enterprises.pullNotificationSetEnterprises.acknowledgeNotificationSet,透過長時間運行的傳出連線接收及確認 EMM 通知。

呼叫 Enterprises.pullNotificationSet 時,建議將 requestMode 設為預設值 (waitForNotifications)。這樣一來,要求會等到出現一或多則通知,再傳回回應。如果一段時間後沒有任何通知,要求會傳回空的通知清單,您可以嘗試再次提出要求。

收到通知後,請呼叫 Enterprises.acknowledgeNotificationSet,確保下次呼叫 Enterprises.pullNotificationSet 時不會傳回相同的通知。

您也可以在呼叫 Enterprises.pullNotificationSet 時將 requestMode 設為 returnImmediately。您會立即收到要求的回應,其中包含任何待處理的通知,如果沒有通知,則會收到空白清單。您初次測試通知導入作業時,可能會需要使用這個 requestMode 選項。

EMM 通知範例

以下列舉一些事件和事件產生的通知類型:

注意:下列通知類型已淘汰:ProductApprovalEventAppUpdateEventNewPermissionsEventAppRestrictionsSchemaChangeEventProductAvailabilityChangeEventNewDeviceEvent。針對 AppUpdateEvent,您必須按照我們的建議使用 高優先順序更新模式

說明通知
透過 Google Play EMM API 要求測試通知。您需要傳送測試通知,確認系統可以接收 Google Play 發布的通知,並瞭解與 Google Play 相關聯的所有通知所使用的主題名稱。TestPushNotification
新提供的裝置已準備就緒,可由 Google Play EMM API 管理。您現在可以呼叫需要裝置 deviceId (例如 Installs) 的 API,以及傳回 Devices 資源的 API。只有在受管理裝置上設定第一個帳戶後,系統才會傳送這則通知。已淘汰 NewDeviceEvent
管理員會在 Google Play 管理版控制台將應用程式標示為已核准或未核准。已淘汰 ProductApprovalEvent
裝置的待安裝作業逾時。舉例來說,系統已接受推送安裝要求,但裝置在幾天內無法連線,因此無法確認安裝作業。系統會傳送安裝逾時通知。InstallFailureEvent
應用程式已發布新版本。更新可供一或多部裝置使用,但不一定適用於所有裝置。已淘汰 AppUpdateEvent
應用程式更新需要新的權限才能獲得管理員核准,才能進行更新或新安裝作業。如果應用程式接受的權限組合與應用程式要求的權限組合不同,系統就會傳送這則通知。已淘汰 NewPermissionsEvent
發布新版應用程式,其中包含新的或修改過的受管理設定結構定義。開發人員上傳新 APK 時,Google Play 會將資訊清單中的結構定義與應用程式先前版本中的結構定義進行比較。如果結構定義已變更,系統會通知已核准應用程式的企業。已淘汰 AppRestrictionsSchemaChangeEvent
可用的應用程式變成無法使用,或是無法使用的應用程式重新加入 Google Play。如果開發人員取消發布應用程式,或是應用程式從 Google Play 下架,應用程式可用性就會有所變動。如果未開放的應用程式重新加入 Google Play,供應情形也會隨之變更。已淘汰 ProductAvailabilityChangeEvent
與企業升級相關的通知。企業升級是將 Google Play 管理版帳戶企業升級為 Google 管理版網域的程序。 EnterpriseUpgradeEvent