Enterprises

有关此类资源的方法列表,请参阅本页面的结尾部分。

资源表示形式

Enterprises 资源表示 EMM 与特定组织之间的绑定。使用此 API 可以通过两种不同方式之一将该绑定实例化,如下所示:

  • 对于 Google 管理的网域客户,此流程需要使用 Enterprises.enrollEnterprises.setAccount(以及从管理控制台和 Google API 控制台获取的制品),然后通过或多或少的手动流程提交到 EMM。
  • 对于 Google Play 企业版账号客户,该流程涉及使用 Enterprises.generateSignupUrlEnterprises.completeSignup 与 Google Play 企业版注册界面(Google 提供的机制)创建绑定,无需手动执行相关步骤。
作为 EMM,您可以在 EMM 控制台中支持任一方法或同时支持这两种方法。有关详情,请参阅创建企业

{
  "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 取消注册企业。