Grouplicenses

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

资源表示形式

借助群组许可对象,您可以跟踪免费应用和付费应用的许可(称为使用权)。对于免费应用,当企业管理员首次在 Google Play 中批准产品时,或通过 API 为用户创建产品的第一个使用权时,系统会创建群组许可。对于付费应用,只有在企业管理员首次在 Google Play 中购买产品时,系统才会创建群组许可对象。

使用 API 查询群组许可。Grouplicenses 资源包括购买的许可总数(仅限付费应用)和目前正在使用的许可总数。换句话说,商品存在的 Entitlements 的总数。

每个产品只能创建一个群组许可对象,并且永远不会删除群组许可对象。如果产品未获批准,其群组许可会保留。这样一来,企业管理员可以跟踪产品的所有剩余使用权。

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
属性名称 说明 备注
acquisitionKind string 此群组许可的获取方式。"bulkPurchase" 表示创建此 Grouplicenses 资源是因为企业购买了此产品的许可;否则,该值为 "free"(针对免费产品)。

可接受的值包括: <ph type="x-smartling-placeholder">
    </ph>
  • bulkPurchase
  • free
approval string 与此群组许可相关的产品目前是否已获得企业的批准。首次创建群组许可后,产品就会获得批准,但企业管理员可通过 Google Play 撤消此批准操作。集合中的最终用户将看不到未获批的商品,并且通常不应为这些商品创建新使用权。

可接受的值包括:
  • approved
  • unapproved
kind string
numProvisioned integer 此产品已配置的许可总数。由读取操作返回,但在写入操作中会被忽略。
numPurchased integer 已购买许可的数量(可能会购买多次)。如果省略此字段,则可配置的许可数量不受限制(例如,流量获取种类为 "free")。
permissions string 产品的权限审批状态。只有在产品获得批准后,才会设置此字段。可能的状态包括:
  • currentApproved”,当前这组权限已获批准,但额外的权限将需要管理员重新批准商品(如果商品在未获批准时未指定已获准的权限设置,则这是默认行为)。
  • needsReapproval”,表示该产品具有未获批准的权限。在产品重新获得批准之前,无法分配额外的产品许可。
  • allCurrentAndFutureApproved”,当前的权限已获批准,日后的所有权限更新都将自动获得批准,无需管理员审核。


可接受的值:
  • allCurrentAndFutureApproved
  • currentApproved
  • needsReapproval
productId string 许可所针对的产品的 ID。例如 "app:com.google.android.gm"

方法

get
检索某个产品的企业群组许可详细信息。
list
检索企业拥有群组许可的所有产品的 ID。