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 的 API(例如 Installs)以及返回 Devices 资源的 API。只有在受管理设备上预配第一个账号后,系统才会发送此通知。已弃用
| NewDeviceEvent |
管理员在 Google Play 企业版控制台中将应用标记为已批准或未批准。已弃用 | ProductApprovalEvent
|
设备上的待处理安装超时。例如,系统接受了推送安装请求,但设备几天都无法访问,因此无法确认安装。系统会发送安装超时通知。 | InstallFailureEvent
|
发布应用的新版本。更新适用于一个或多个设备,但不一定适用于所有设备。已弃用 | AppUpdateEvent
|
应用更新需要获得管理员批准的新权限,才能进行更新或新安装。当应用接受的权限集与应用请求的权限集不同时,系统会发送此通知。已弃用 | NewPermissionsEvent |
发布了应用的新版本,其中包含新的或经过修改的受管理的配置架构。当开发者上传新的 APK 时,Google Play 会将清单中的架构与应用的旧版本中的架构进行比较。如果架构发生了变化,Google Play 会通知已批准该应用的企业。已废弃 | AppRestrictionsSchemaChangeEvent |
可用的应用变为不可用,或者不可用的应用重新添加到 Google Play。如果开发者取消发布应用或应用从 Google Play 下架,应用的可用性就会发生变化。如果已下架的应用重新添加到 Google Play,其上架情况也会随之发生变化。已弃用 | ProductAvailabilityChangeEvent |
与企业升级相关的通知。企业升级是指将 Google Play 企业版账号集升级为 Google 企业版域名的过程。 | EnterpriseUpgradeEvent |