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" 表示此实例组许可资源已创建，因为企业购买了此产品的许可；否则，该值为 "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。注意：此项已弃用。新集成无法使用此方法，并且可以参考我们的新建议。