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.pullNotificationSet
和 Enterprises.acknowledgeNotificationSet
通过长时间运行的传出连接接收和确认 EMM 通知。
调用 Enterprises.pullNotificationSet
时,我们建议将 requestMode
保留为默认值 (waitForNotifications
)。这会导致请求等到一个或多个通知出现后才会返回响应。如果一段时间后没有显示任何通知,请求会返回一个空的通知列表,您可以稍后重新尝试该请求。
收到通知后,请调用 Enterprises.acknowledgeNotificationSet
,以确保在您下次调用 Enterprises.pullNotificationSet
时不会返回相同的通知。
在调用 Enterprises.pullNotificationSet
时,您还可以选择将 requestMode
设置为 returnImmediately
。您将立即收到对该请求的响应,其中包含所有待处理的通知;如果没有通知,则为空列表。在最初测试通知实现时,此 requestMode
选项可能很有用。
EMM 通知示例
下面列举了一些示例来说明事件及其生成的通知类型:
注意:以下通知类型已废弃:ProductApprovalEvent
、AppUpdateEvent
、NewPermissionsEvent
、AppRestrictionsSchemaChangeEvent
、ProductAvailabilityChangeEvent
和 NewDeviceEvent
。对于 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 |