如需了解此资源的方法列表,请参阅本页结尾部分。
资源表示形式
Enterprise 资源表示 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 之前调用;在其他情况下,此方法会返回错误。
在第 1 次调用之后的后续调用将生成一组唯一的新凭据,并使先前生成的凭据失效。
服务帐号绑定到企业后,可以使用 serviceAccountKeys 资源进行管理。 - getStoreLayout
- 返回商家的商店布局。如果未设置商店布局,则返回“基本”作为商店布局类型,而不返回首页。
- list
- 按域名查找企业。 只有通过 Google 发起的创建流程创建的企业才支持这种做法。由于 EMM 会在 Enterprises.generateSignupUrl 调用中指定的回调中获知企业 ID,因此通过 EMM 启动的流程创建的企业无需查询此 ID。
- 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 取消注册企业。