設定 EMM 通知

Google Play 會根據各種影響企業的事件產生通知,稱為「EMM 通知」。例如,當應用程式獲得核准時,系統會傳送 ProductApprovalEvent 通知。

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

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

如要確認系統是否已成功設定系統,可接收來自 Google Play 的 EMM 通知,以及擷取訂閱項目連線所需的 Cloud Pub/Sub 主題名稱,請呼叫 Enterprises.sendTestPushNotification

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

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

提取通知

Google Cloud Pub/Sub 支援兩種不同的通知機制:提取和推送。不過,建議只設定提取通知。提取方法不需要任何外部伺服器設定,而且可搭配程式和手動建立的 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,以及會傳回「裝置」資源的 API。在受管理的裝置上佈建第一個帳戶之後,系統才會傳送這則通知。已淘汰NewDeviceEvent
管理員在 Google Play 管理版主控台中,將應用程式標示為已核准或未核准。已淘汰ProductApprovalEvent
裝置待處理的安裝作業逾時。舉例來說,使用者已接受推送安裝要求,但已有數天無法連上裝置,因此無法確認安裝作業。系統會傳送安裝逾時通知。InstallFailureEvent
應用程式有新版本發布。更新會提供給一或多個裝置,但不一定適用於所有裝置。已淘汰AppUpdateEvent
應用程式更新需要新權限獲得管理員核准,才能進行更新或安裝。如果應用程式接受的權限集不同於應用程式要求的權限集,系統就會傳送這則通知。已淘汰NewPermissionsEvent
系統會發布新版應用程式,包含新的或修改版受管理的設定結構定義。當開發人員上傳新的 APK 時,Google Play 會比較資訊清單中的結構定義與先前應用程式版本中的結構定義。如果結構定義有所變更,系統會通知企業已核准該應用程式。DEPRECATED AppRestrictionsSchemaChangeEvent
可用的應用程式已無法使用,或是將某個無法使用的應用程式重新加入 Google Play。如果開發人員取消發布或從 Google Play 下架,應用程式的供應情形會隨之變更。如果在 Google Play 重新加入無法使用的應用程式,供應情形也會改變。已淘汰 ProductAvailabilityChangeEvent