设置 EMM 通知

Google Play 会生成通知(称为“EMM 通知”),以响应影响企业的各种事件。例如,当应用获得批准时,系统会发送 ProductApprovalEvent 通知。

EMM 通知与特定的企业服务帐号 (ESA) 相关联。作为 EMM,您可以将控制台设置为根据您收到的通知向企业 IT 管理员显示提醒或消息。

EMM 通知使用 Google Cloud Pub/Sub 发送。如需详细了解如何设置 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 和返回 Devices 资源的 API。此通知仅在受管设备上配置第一个帐号后发送。 已弃用 NewDeviceEvent
管理员在 Google Play 企业版控制台中将应用标记为已批准或未批准。已弃用 ProductApprovalEvent
向设备安装的待处理安装超时。例如,系统接受了推送安装请求,但设备在几天内都无法访问,因此无法确认安装。系统会发送安装超时通知。InstallFailureEvent
发布了应用的新版本。更新适用于一台或多台设备,但不一定可供所有设备使用。已弃用 AppUpdateEvent
应用更新需要获得管理员批准的新权限,才能进行更新或新安装。当应用接受的权限设置与应用请求的权限设置不同时,系统会发送此通知。已弃用 NewPermissionsEvent
发布了应用的新版本,其中包含新的或修改的托管配置架构。当开发者上传新的 APK 时,Google Play 会将清单中的架构与先前应用版本中的架构进行比较。如果架构已更改,它会通知已批准应用的企业。已弃用 AppRestrictionsSchemaChangeEvent
可用应用变得不可用,或者不可用的应用会重新添加到 Google Play。如果应用被开发者取消发布或从 Google Play 下架,其可用性会发生变化。如果不可用的应用被重新添加到 Google Play,可用性也会发生变化。已弃用 ProductAvailabilityChangeEvent