blob: b6891468b9b3913665cbff722f8d40418e56814f [file] [log] [blame]
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +00001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
Nathaniel Manista4f877e52015-06-15 16:44:50 +000075<h1><a href="androidenterprise_v1.html">Google Play EMM API</a> . <a href="androidenterprise_v1.grouplicenses.html">grouplicenses</a></h1>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +000076<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070078 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070081 <code><a href="#get">get(enterpriseId, groupLicenseId, x__xgafv=None)</a></code></p>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +000082<p class="firstline">Retrieves details of an enterprise's group license for a product.</p>
83<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070084 <code><a href="#list">list(enterpriseId, x__xgafv=None)</a></code></p>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +000085<p class="firstline">Retrieves IDs of all products for which the enterprise has a group license.</p>
86<h3>Method Details</h3>
87<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070088 <code class="details" id="close">close()</code>
89 <pre>Close httplib2 connections.</pre>
90</div>
91
92<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070093 <code class="details" id="get">get(enterpriseId, groupLicenseId, x__xgafv=None)</code>
Bu Sun Kim65020912020-05-20 12:08:20 -070094 <pre>Retrieves details of an enterprise&#x27;s group license for a product.
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +000095
96Args:
97 enterpriseId: string, The ID of the enterprise. (required)
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070098 groupLicenseId: string, The ID of the product the group license is for, e.g. &quot;app:com.google.android.gm&quot;. (required)
Bu Sun Kimd059ad82020-07-22 17:02:09 -070099 x__xgafv: string, V1 error format.
100 Allowed values
101 1 - v1 error format
102 2 - v2 error format
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000103
104Returns:
105 An object of the form:
106
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700107 { # 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.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800108 &quot;acquisitionKind&quot;: &quot;A String&quot;, # How this group license was acquired. &quot;bulkPurchase&quot; means that this Grouplicenses resource was created because the enterprise purchased licenses for this product; otherwise, the value is &quot;free&quot; (for free products).
109 &quot;approval&quot;: &quot;A String&quot;, # 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.
110 &quot;numProvisioned&quot;: 42, # The total number of provisioned licenses for this product. Returned by read operations, but ignored in write operations.
111 &quot;numPurchased&quot;: 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 &quot;free&quot;).
112 &quot;permissions&quot;: &quot;A String&quot;, # The permission approval status of the product. This field is only set if the product is approved. Possible states are: - &quot;currentApproved&quot;, 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.), - &quot;needsReapproval&quot;, the product has unapproved permissions. No additional product licenses can be assigned until the product is reapproved, - &quot;allCurrentAndFutureApproved&quot;, the current permissions are approved and any future permission updates will be automatically approved without administrator review.
113 &quot;productId&quot;: &quot;A String&quot;, # The ID of the product that the license is for. For example, &quot;app:com.google.android.gm&quot;.
114}</pre>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000115</div>
116
117<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700118 <code class="details" id="list">list(enterpriseId, x__xgafv=None)</code>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000119 <pre>Retrieves IDs of all products for which the enterprise has a group license.
120
121Args:
122 enterpriseId: string, The ID of the enterprise. (required)
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700123 x__xgafv: string, V1 error format.
124 Allowed values
125 1 - v1 error format
126 2 - v2 error format
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000127
128Returns:
129 An object of the form:
130
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700131 {
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800132 &quot;groupLicense&quot;: [ # A group license for a product approved for use in the enterprise.
133 { # 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.
134 &quot;acquisitionKind&quot;: &quot;A String&quot;, # How this group license was acquired. &quot;bulkPurchase&quot; means that this Grouplicenses resource was created because the enterprise purchased licenses for this product; otherwise, the value is &quot;free&quot; (for free products).
135 &quot;approval&quot;: &quot;A String&quot;, # 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.
136 &quot;numProvisioned&quot;: 42, # The total number of provisioned licenses for this product. Returned by read operations, but ignored in write operations.
137 &quot;numPurchased&quot;: 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 &quot;free&quot;).
138 &quot;permissions&quot;: &quot;A String&quot;, # The permission approval status of the product. This field is only set if the product is approved. Possible states are: - &quot;currentApproved&quot;, 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.), - &quot;needsReapproval&quot;, the product has unapproved permissions. No additional product licenses can be assigned until the product is reapproved, - &quot;allCurrentAndFutureApproved&quot;, the current permissions are approved and any future permission updates will be automatically approved without administrator review.
139 &quot;productId&quot;: &quot;A String&quot;, # The ID of the product that the license is for. For example, &quot;app:com.google.android.gm&quot;.
140 },
141 ],
142}</pre>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000143</div>
144
145</body></html>