get(enterpriseId, groupLicenseId, x__xgafv=None)
Retrieves details of an enterprise's group license for a product.
list(enterpriseId, x__xgafv=None)
Retrieves IDs of all products for which the enterprise has a group license.
get(enterpriseId, groupLicenseId, x__xgafv=None)
Retrieves details of an enterprise's group license for a product.
Args:
enterpriseId: string, The ID of the enterprise. (required)
groupLicenseId: string, The ID of the product the group license is for, e.g.
"app:com.google.android.gm". (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Group license objects allow you to keep track of licenses (called
# <a href="/android/work/play/emm-api/v1/entitlements">entitlements</a>)
# 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 <code>Grouplicenses</code> 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 <code>Entitlements</code> 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.
"numProvisioned": 42, # The total number of provisioned licenses for this product.
# Returned by read operations, but ignored in write operations.
"approval": "A 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.
"numPurchased": 42, # 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
# <code>"free"</code>).
"acquisitionKind": "A String", # How this group license was acquired. <code>"bulkPurchase"</code>
# means that this Grouplicenses resource was created because the enterprise
# purchased licenses for this product; otherwise, the value is
# <code>"free"</code> (for free products).
"productId": "A String", # The ID of the product that the license is for. For example,
# <code>"app:com.google.android.gm"</code>.
"permissions": "A String", # The permission approval status of the product. This field
# is only set if the product is approved. Possible states are:<ul>
# <li>"<code>currentApproved</code>", 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.),</li>
# <li>"<code>needsReapproval</code>", the product has unapproved permissions.
# No additional product licenses can be assigned until the product is
# reapproved,</li>
# <li>"<code>allCurrentAndFutureApproved</code>",
# the current permissions are approved and any future permission updates
# will be automatically approved without administrator review.</li></ul>
}
list(enterpriseId, x__xgafv=None)
Retrieves IDs of all products for which the enterprise has a group license.
Args:
enterpriseId: string, The ID of the enterprise. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{
"groupLicense": [ # A group license for a product approved for use in the enterprise.
{ # Group license objects allow you to keep track of licenses (called
# <a href="/android/work/play/emm-api/v1/entitlements">entitlements</a>)
# 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 <code>Grouplicenses</code> 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 <code>Entitlements</code> 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.
"numProvisioned": 42, # The total number of provisioned licenses for this product.
# Returned by read operations, but ignored in write operations.
"approval": "A 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.
"numPurchased": 42, # 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
# <code>"free"</code>).
"acquisitionKind": "A String", # How this group license was acquired. <code>"bulkPurchase"</code>
# means that this Grouplicenses resource was created because the enterprise
# purchased licenses for this product; otherwise, the value is
# <code>"free"</code> (for free products).
"productId": "A String", # The ID of the product that the license is for. For example,
# <code>"app:com.google.android.gm"</code>.
"permissions": "A String", # The permission approval status of the product. This field
# is only set if the product is approved. Possible states are:<ul>
# <li>"<code>currentApproved</code>", 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.),</li>
# <li>"<code>needsReapproval</code>", the product has unapproved permissions.
# No additional product licenses can be assigned until the product is
# reapproved,</li>
# <li>"<code>allCurrentAndFutureApproved</code>",
# the current permissions are approved and any future permission updates
# will be automatically approved without administrator review.</li></ul>
},
],
}