For a list of methods for this resource, see the end of this page.
Resource representations
Group license objects allow you to keep track of licenses (called entitlements) for both free and paid apps. For a free app, a group license is created when an enterprise admin first approves the product in Google Play or when the first entitlement for the product is created for a user via the API. For a paid app, a group license object is only created when an enterprise admin purchases the product in Google Play for the first time.
Use the API to query group licenses. A Grouplicenses
resource includes the total number of licenses purchased (paid apps only) and the total number of licenses currently in use. In other words, the total number of Entitlements
that exist for the product.
Only one group license object is created per product and group license objects are never deleted. If a product is unapproved, its group license remains. This allows enterprise admins to keep track of any remaining entitlements for the product.
{ "kind": "androidenterprise#groupLicense", "productId": string, "numPurchased": integer, "numProvisioned": integer, "acquisitionKind": string, "approval": string, "permissions": string }
Property name | Value | Description | Notes |
---|---|---|---|
acquisitionKind |
string |
How this group license was acquired. "bulkPurchase" means that this Grouplicenses resource was created because the enterprise purchased licenses for this product; otherwise, the value is "free" (for free products).
Acceptable values are:
|
|
approval |
string |
Whether the product to which this group license relates is currently approved by the enterprise. Products are approved when a group license is first created, but this approval may be revoked by an enterprise admin via Google Play. Unapproved products will not be visible to end users in collections, and new entitlements to them should not normally be created.
Acceptable values are:
|
|
kind |
string |
||
numProvisioned |
integer |
The total number of provisioned licenses for this product. Returned by read operations, but ignored in write operations. | |
numPurchased |
integer |
The number of purchased licenses (possibly in multiple purchases). If this field is omitted, then there is no limit on the number of licenses that can be provisioned (for example, if the acquisition kind is "free" ). |
|
permissions |
string |
The permission approval status of the product. This field is only set if the product is approved. Possible states are:
Acceptable values are:
|
|
productId |
string |
The ID of the product that the license is for. For example, "app:com.google.android.gm" . |