设置 Pub/Sub 通知

注意： 如果现有 EMM 合作伙伴以编程方式创建了 ESA，则需要先向 Google 注册首选 Cloud 项目，然后才能为 Android Management API 设置 Pub/Sub 通知。如需了解详情，请参阅面向现有 EMM 合作伙伴的指南。

借助 Pub/Sub 通知，您可以接收有关新注册的设备、设备报告和最近发出的命令的提醒。

如需设置 Pub/Sub 通知，您需要启用 Pub/Sub API 并创建主题。如需接收发布到某个主题的消息，请创建对该主题的订阅。订阅将主题与负责接收和处理发布到该主题的消息的订阅者应用关联起来。创建订阅后，您需要向 Android Device Policy 授予向您的主题发布消息的权限。

1. 为您的项目启用 Pub/Sub API

如需了解如何启用 Pub/Sub API，请参阅 Cloud 控制台快速入门指南。确保您选择的项目与已启用 Android Management API 的项目相同。

2. 创建主题

启用该 API 后，您需要创建一个 Android Device Policy 可以发布通知到的主题。您可以通过以下两种方式创建主题：

a. 在 Google Cloud 控制台中手动执行。
b. 使用 Pub/Sub API（请参阅创建主题方法）。

创建主题后，记下主题名称。

3. 创建订阅

订阅会捕获发布到给定主题的消息流。您可以通过以下两种方式创建订阅：

a. 在 Google Cloud 控制台中手动执行。
b. 使用 Pub/Sub API（请参阅创建订阅方法）。

4. 向 Android Device Policy 授予向您的主题发布消息的权限

您需要向 [e-mail] 授予向您的主题发布消息的权限。您可以通过以下两种方式授予发布权：

a. 在 Google Cloud 控制台中手动执行。

• 将 [e-mail] 添加为主题的成员。
• 依次点击选择角色 > Pub/Sub > Pub/Sub 发布者。

b. 使用 Pub/Sub API（请参阅通过 IAM API 控制访问权限）

• 将 serviceAccount:[e-mail] 添加到 members。
• 将 role 设置为 roles/pubsub.publisher。

5. 更新企业版以支持通知

如果您要支持的通知是 ENTERPRISE_UPGRADE（始终受支持），请跳过此步骤。

如需将与某个企业有关的通知与您创建的主题相关联，请调用 enterprises.patch 并指定以下参数：

• pubsubTopic：您的 Pub/Sub 主题的名称，格式为 projects/{project}/topics/{topic}。
• enabledNotificationTypes：包含您要接收的所有通知类型。从 ENROLLMENT、STATUS_REPORT 和 COMMAND 中进行选择。

6. 使用 Pub/Sub API 获取通知

订阅可以使用推送或拉取机制来传送消息。如需了解如何通过这两种机制接收通知，请参阅 Pub/Sub 订阅者指南。

消息格式

消息采用 PubsubMessage 的形式。消息的 attributes 字段包含一个键为 notificationType 且值设为触发消息的通知类型（例如 ENROLLMENT）的属性。消息的 data 字段包含已更新资源的 JSON 表示法，该表示法编码为 UTF-8 字符串。通知及其对应的资源类型如下所示：

• COMMAND 通知使用 Operation 资源类型。
• USAGE_LOGS 通知使用资源类型 UsageLogEvent。
• ENROLLMENT 和 STATUS_REPORT 通知使用资源类型 Device。
• ENTERPRISE_UPGRADE 通知使用资源类型 EnterpriseUpgradeEvent。

在企业端设置 pubsubTopic 时，系统会发布一条初始消息，并将 notificationType 设置为 test。此消息用于验证 Android Device Policy 是否对相应主题拥有发布权限，因此应被忽略。

注意 ：使用 Pub/Sub REST API 时，data 字段会编码为 base64 字符串。如需获取资源 JSON，请先对 data 的内容执行 base64 解码，然后将生成的字节解读为 UTF-8 字符串。

预期延迟时间

企业版升级事件应立即发送。

系统会将快速连续发生的本地设备事件批量处理，并在单个 Pub/Sub 消息中报告给 EMM。

事件类型	设备端事件与相应 EMM 通知之间的预期延迟时间^1
高优先级键值对应用状态	立即，每分钟最多发送一次报告
标准优先级键值对应用状态	1 分钟内
配置期间与应用相关的事件（适用于 IT 管理员定义了安装状态的应用）^2	在其他相关配置事件之外，1 分钟内
配置后的应用相关事件，适用于由 IT 管理员定义安装状态的应用。	5 分钟内
在配置期间和配置后，对于由员工定义安装状态的应用，与应用相关的事件^3	60 分钟内
其他设备端应用事件	60 分钟内

---

1. 基于受控环境的尽力目标。实际延迟时间可能会因各种设备和环境因素而异。 ↩

2. 政策中强制执行的应用的InstallType：FORCE_INSTALLED、BLOCKED、REQUIRED_FOR_SETUP、PREINSTALLED 和 KIOSK。 ↩

3. 可用应用的 InstallType：AVAILABLE、INSTALL_TYPE_UNSPECIFIED。 ↩