Enterprises

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

资源表示形式

“企业”资源表示 EMM 与特定组织之间的绑定。您可以使用此 API 通过以下两种不同的方式之一实例化该绑定，如下所示：

对于 Google 管理的网域客户，该流程涉及使用 Enterprises.enroll 和 Enterprises.setAccount（以及从管理控制台和 Google API 控制台获取的工件），并通过大致手动流程提交给 EMM。
对于受管理的 Google 账号客户，该流程涉及将 Enterprises.generateSignupUrl 和 Enterprises.completeSignup 与受管理的 Google 账号注册界面（Google 提供的机制）结合使用，以便在不执行任何手动步骤的情况下创建绑定。

作为 EMM，您可以在 EMM 控制台中支持这两种方法中的一种或两种。如需了解详情，请参阅创建企业。

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ],
  "enterpriseType": string,
  "managedGoogleDomainType": string
}

属性名称	值	说明
`administrator[]`	`list`	企业的管理员。只有通过 EMM 发起的流程创建的企业才支持此功能。
`administrator[].email`	`string`	管理员的电子邮件地址。
`enterpriseType`	`string`	企业的类型。可接受的值包括： “`enterpriseTypeUnspecified`” “`managedGoogleDomain`” “`managedGooglePlayAccountsEnterprise`”
`id`	`string`	企业的唯一 ID。
`kind`	`string`
`managedGoogleDomainType`	`string`	受管理的 Google 网域的类型可接受的值： “`managedGoogleDomainTypeUnspecified`” “`typeDomain`” “`typeTeam`”
`name`	`string`	企业的名称，例如“Example, Inc”。
`primaryDomain`	`string`	企业的主域名，例如“example.com”。

方法

acknowledgeNotificationSet: 确认从 Enterprise.PullNotificationSet 收到的通知，以防止后续调用返回相同的通知。
completeSignup: 通过指定完成令牌和企业令牌来完成注册流程。不得针对给定企业令牌多次调用此请求。
createWebToken: 返回用于访问可嵌入界面的唯一令牌。如需生成 Web 界面，请将生成的令牌传递到 Google Play 企业版 JavaScript API。每个令牌只能用于启动一个界面会话。如需了解详情，请参阅 JavaScript API 文档。
注册: 向发起调用的 EMM 注册企业。
generateSignupUrl: 生成注册网址。
get: 检索企业的名称和域名。
getServiceAccount: 返回服务账号和凭据。您可以通过调用 setAccount 将服务账号绑定到企业。此服务账号是此企业和 EMM 的专属账号，如果企业解除绑定，该账号将被删除。凭据包含私钥数据，且不会存储在服务器端。

此方法只能在调用 Enterprises.Enroll 或 Enterprises.CompleteSignup 之后且在调用 Enterprises.SetAccount 之前调用；在其他时间调用此方法将会返回错误。

首次调用后，后续调用将生成一组新的唯一凭据，并使之前生成的凭据失效。

将服务账号绑定到企业后，您可以使用 serviceAccountKeys 资源进行管理。
getStoreLayout: 返回企业的商店布局。如果尚未设置商店布局，则返回“基本”作为商店布局类型，并且没有首页。
list: 按域名查找企业。只有通过 Google 发起的创建流程创建的企业才支持此操作。对于通过 EMM 发起的流程创建的企业，无需查找 ID，因为 EMM 会在 Enterprises.generateSignupUrl 调用中指定的回调中了解企业 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 中取消注册企业。