Get

2 variables

7 variables

Retrieves details of an enterprise's group license for a product

Authorization

To use this building block you will have to grant access to at least one of the following scopes:

Manage corporate Android devices

Input

This building block consumes 2 input parameters

Name	Format	Description
`enterpriseId` Required	`STRING`	The ID of the enterprise
`groupLicenseId` Required	`STRING`	The ID of the product the group license is for, e.g. "app:com.google.android.gm"

= Parameter name
= Format

enterpriseId STRING Required

The ID of the enterprise

groupLicenseId STRING Required

The ID of the product the group license is for, e.g. "app:com.google.android.gm"

Output

This building block provides 7 output parameters

Name	Format	Description
`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)
`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
`kind`	`STRING`	Identifies what kind of resource this is. Value: the fixed string "androidenterprise#groupLicense"
`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: "currentApproved", the current set of permissions is approved, but additional permissions will require the administrator to reapprove the product (If the product was approved without specifying the approved permissions setting, then this is the default behavior.), "needsReapproval", the product has unapproved permissions. No additional product licenses can be assigned until the product is reapproved, "allCurrentAndFutureApproved", the current permissions are approved and any future permission updates will be automatically approved without administrator review.
`productId`	`STRING`	The ID of the product that the license is for. For example, "app:com.google.android.gm"

= Parameter name
= Format

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)

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

kind STRING

Identifies what kind of resource this is. Value: the fixed string "androidenterprise#groupLicense"

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:

"currentApproved", the current set of permissions is approved, but additional permissions will require the administrator to reapprove the product (If the product was approved without specifying the approved permissions setting, then this is the default behavior.),
"needsReapproval", the product has unapproved permissions. No additional product licenses can be assigned until the product is reapproved,
"allCurrentAndFutureApproved", the current permissions are approved and any future permission updates will be automatically approved without administrator review.

productId STRING

The ID of the product that the license is for. For example, "app:com.google.android.gm"