有关此类资源的方法列表,请参阅本页面的结尾部分。
资源表示形式
Enterprises 资源表示 EMM 与特定组织之间的绑定。使用此 API 可以通过两种不同方式之一将该绑定实例化,如下所示:
- 对于 Google 管理的网域客户,此流程需要使用
Enterprises.enroll
和Enterprises.setAccount
(以及从管理控制台和 Google API 控制台获取的制品),然后通过或多或少的手动流程提交到 EMM。 - 对于 Google Play 企业版账号客户,该流程涉及使用
Enterprises.generateSignupUrl
和Enterprises.completeSignup
与 Google Play 企业版注册界面(Google 提供的机制)创建绑定,无需手动执行相关步骤。
{ "kind": "androidenterprise#enterprise", "id": string, "primaryDomain": string, "name": string, "administrator": [ { "email": string } ] }
属性名称 | 值 | 说明 | 备注 |
---|---|---|---|
administrator[] |
list |
企业管理员。只有通过 EMM 发起的流程创建的企业才支持此功能。 |
|
administrator[].email |
string |
管理员的电子邮件地址。 | |
id |
string |
企业的唯一 ID。 |
|
kind |
string |
||
name |
string |
企业的名称,例如“Example, Inc”。 | |
primaryDomain |
string |
企业的主域名,例如“example.com”。 |
方法
- acknowledgeNotificationSet
- 确认接收来自以下设备的通知 Enterprises.PullNotificationSet 来防止返回后续调用 相同的通知
- completeSignup
- 指定完成令牌并完成注册流程 企业令牌。 对于给定的企业,不得多次调用此请求 令牌。
- createWebToken
- 返回一个用于访问可嵌入式界面的唯一令牌。要生成 网页界面,将生成的令牌传递到 Google Play 企业版 JavaScript API。每个令牌只能用于启动一个界面会话。请参阅 JavaScript API 文档了解详情。
- 注册
- 向发起调用的 EMM 注册企业。
- generateSignupUrl
- 生成一个注册网址。
- get
- 检索企业的名称和网域。
- getServiceAccount
- 返回服务账号和凭据。服务账号
可以通过调用 setAccount 绑定到该企业服务账号
专属于此企业和 EMM,如果企业
没有绑定凭据包含私钥数据,未存储
。
(
) 此方法只能在调用 Enterprises.enroll 或 Enterprises.CompleteSignup 及之前 Enterprises.SetAccount;但有时会返回错误。
(
) 在第一次调用之后的后续调用将生成一组新的唯一 并使之前生成的凭据失效。
(
) 服务账号绑定到企业账号后,即可对其进行管理 直接使用 serviceAccountKeys 资源。 - getStoreLayout
- 返回企业的商店布局。如果商店布局 尚未设置,则返回“basic”作为商店布局类型, 首页。
- list
- 按域名查找企业。 只有通过 Google 发起的 创建流程通过 由于 EMM 在 2023 年 3 月 8 日之前学习了 (在 Enterprises.generateSignupUrl 调用中指定)。
- pullNotificationSet
- 拉取并返回针对以下对象所设企业的通知集:
针对请求进行身份验证的服务账号。通知集可能会
为空。
返回的通知集需要在 20 秒内确认 通过调用 Enterprises.AcknowledgeNotificationSet, 通知设置为空。
如果您未在 20 秒内确认通知, 最终会再次包含在对另一个 PullNotificationSet 的响应中 那些从未被确认的请求最终会被删除 将遵守 Google Cloud Platform Pub/Sub 系统政策
可以同时执行多个请求,以检索 通知,在这种情况下,待处理通知(如果有)将 分配(如果有待处理的调用)。
如果没有通知,则返回空的通知列表。 一旦这些请求变为实际状态,后续请求可能会返回更多通知 可用。 - sendTestPushNotification
- 发送测试通知以验证 EMM 集成: 适用于此企业的 Google Cloud Pub/Sub 服务
- setAccount
- 将用于对 API 进行身份验证的账号设置为 企业。
- setStoreLayout
- 为企业设置商店布局。默认情况下,storeLayoutType 设置为“basic”并且已启用基本商店布局基本功能 布局仅包含已由管理员批准的应用,且这些应用 添加到用户的可用商品集(使用 setAvailableProductSet 调用中)。页面上的应用会按 产品 ID 值。如果您通过设置 storeLayoutType = "custom"和设置首页), 已停用。
- 取消注册
- 为发起调用的 EMM 取消注册企业。