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"（针对免费产品）。

可接受的值包括：
  • "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。