blob: 4e62b7b21b65f95b1005f8982fbb4fe015db0193 [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.enterprises.html">enterprises</a></h1>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +000076<h2>Instance Methods</h2>
77<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070078 <code><a href="#acknowledgeNotificationSet">acknowledgeNotificationSet(notificationSetId=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070079<p class="firstline">Acknowledges notifications that were received from Enterprises.PullNotificationSet to prevent subsequent calls from returning the same notifications.</p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -070080<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070081 <code><a href="#close">close()</a></code></p>
82<p class="firstline">Close httplib2 connections.</p>
83<p class="toc_element">
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -080084 <code><a href="#completeSignup">completeSignup(completionToken=None, enterpriseToken=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070085<p class="firstline">Completes the signup flow, by specifying the Completion token and Enterprise token. This request must not be called multiple times for a given Enterprise Token.</p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -070086<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070087 <code><a href="#createWebToken">createWebToken(enterpriseId, body=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070088<p class="firstline">Returns a unique token to access an embeddable UI. To generate a web UI, pass the generated token into the managed Google Play javascript API. Each token may only be used to start one UI session. See the javascript API documentation for further information.</p>
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -070089<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070090 <code><a href="#enroll">enroll(token, body=None, x__xgafv=None)</a></code></p>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -080091<p class="firstline">Enrolls an enterprise with the calling EMM.</p>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +000092<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070093 <code><a href="#generateSignupUrl">generateSignupUrl(callbackUrl=None, x__xgafv=None)</a></code></p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -070094<p class="firstline">Generates a sign-up URL.</p>
95<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070096 <code><a href="#get">get(enterpriseId, x__xgafv=None)</a></code></p>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +000097<p class="firstline">Retrieves the name and domain of an enterprise.</p>
98<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -070099 <code><a href="#getServiceAccount">getServiceAccount(enterpriseId, keyType=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700100<p class="firstline">Returns a service account and credentials. The service account can be bound to the enterprise by calling setAccount. The service account is unique to this enterprise and EMM, and will be deleted if the enterprise is unbound. The credentials contain private key data and are not stored server-side. This method can only be called after calling Enterprises.Enroll or Enterprises.CompleteSignup, and before Enterprises.SetAccount; at other times it will return an error. Subsequent calls after the first will generate a new, unique set of credentials, and invalidate the previously generated credentials. Once the service account is bound to the enterprise, it can be managed using the serviceAccountKeys resource.</p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700101<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700102 <code><a href="#getStoreLayout">getStoreLayout(enterpriseId, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700103<p class="firstline">Returns the store layout for the enterprise. If the store layout has not been set, returns "basic" as the store layout type and no homepage.</p>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800104<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700105 <code><a href="#list">list(domain, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700106<p class="firstline">Looks up an enterprise by domain name. This is only supported for enterprises created via the Google-initiated creation flow. Lookup of the id is not needed for enterprises created via the EMM-initiated flow since the EMM learns the enterprise ID in the callback specified in the Enterprises.generateSignupUrl call.</p>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700107<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700108 <code><a href="#pullNotificationSet">pullNotificationSet(requestMode=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700109<p class="firstline">Pulls and returns a notification set for the enterprises associated with the service account authenticated for the request. The notification set may be empty if no notification are pending. A notification set returned needs to be acknowledged within 20 seconds by calling Enterprises.AcknowledgeNotificationSet, unless the notification set is empty. Notifications that are not acknowledged within the 20 seconds will eventually be included again in the response to another PullNotificationSet request, and those that are never acknowledged will ultimately be deleted according to the Google Cloud Platform Pub/Sub system policy. Multiple requests might be performed concurrently to retrieve notifications, in which case the pending notifications (if any) will be split among each caller, if any are pending. If no notifications are present, an empty notification list is returned. Subsequent requests may return more notifications once they become available.</p>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000110<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700111 <code><a href="#sendTestPushNotification">sendTestPushNotification(enterpriseId, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700112<p class="firstline">Sends a test notification to validate the EMM integration with the Google Cloud Pub/Sub service for this enterprise.</p>
Takashi Matsuo06694102015-09-11 13:55:40 -0700113<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700114 <code><a href="#setAccount">setAccount(enterpriseId, body=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700115<p class="firstline">Sets the account that will be used to authenticate to the API as the enterprise.</p>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000116<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700117 <code><a href="#setStoreLayout">setStoreLayout(enterpriseId, body=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700118<p class="firstline">Sets the store layout for the enterprise. By default, storeLayoutType is set to "basic" and the basic store layout is enabled. The basic layout only contains apps approved by the admin, and that have been added to the available product set for a user (using the setAvailableProductSet call). Apps on the page are sorted in order of their product ID value. If you create a custom store layout (by setting storeLayoutType = "custom" and setting a homepage), the basic store layout is disabled.</p>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800119<p class="toc_element">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700120 <code><a href="#unenroll">unenroll(enterpriseId, x__xgafv=None)</a></code></p>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800121<p class="firstline">Unenrolls an enterprise from the calling EMM.</p>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000122<h3>Method Details</h3>
123<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700124 <code class="details" id="acknowledgeNotificationSet">acknowledgeNotificationSet(notificationSetId=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700125 <pre>Acknowledges notifications that were received from Enterprises.PullNotificationSet to prevent subsequent calls from returning the same notifications.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700126
127Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700128 notificationSetId: string, The notification set ID as returned by Enterprises.PullNotificationSet. This must be provided.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700129 x__xgafv: string, V1 error format.
130 Allowed values
131 1 - v1 error format
132 2 - v2 error format
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700133</pre>
134</div>
135
136<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700137 <code class="details" id="close">close()</code>
138 <pre>Close httplib2 connections.</pre>
139</div>
140
141<div class="method">
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800142 <code class="details" id="completeSignup">completeSignup(completionToken=None, enterpriseToken=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700143 <pre>Completes the signup flow, by specifying the Completion token and Enterprise token. This request must not be called multiple times for a given Enterprise Token.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700144
145Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700146 completionToken: string, The Completion token initially returned by GenerateSignupUrl.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800147 enterpriseToken: string, The Enterprise token appended to the Callback URL.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700148 x__xgafv: string, V1 error format.
149 Allowed values
150 1 - v1 error format
151 2 - v2 error format
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700152
153Returns:
154 An object of the form:
155
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700156 { # An Enterprises resource represents the binding between an EMM and a specific organization. That binding can be instantiated in one of two different ways using this API as follows: - For Google managed domain customers, the process involves using Enterprises.enroll and Enterprises.setAccount (in conjunction with artifacts obtained from the Admin console and the Google API Console) and submitted to the EMM through a more-or-less manual process. - For managed Google Play Accounts customers, the process involves using Enterprises.generateSignupUrl and Enterprises.completeSignup in conjunction with the managed Google Play sign-up UI (Google-provided mechanism) to create the binding without manual steps. As an EMM, you can support either or both approaches in your EMM console. See Create an Enterprise for details.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800157 &quot;administrator&quot;: [ # Admins of the enterprise. This is only supported for enterprises created via the EMM-initiated flow.
158 { # This represents an enterprise admin who can manage the enterprise in the managed Google Play store.
159 &quot;email&quot;: &quot;A String&quot;, # The admin&#x27;s email address.
160 },
161 ],
162 &quot;id&quot;: &quot;A String&quot;, # The unique ID for the enterprise.
163 &quot;name&quot;: &quot;A String&quot;, # The name of the enterprise, for example, &quot;Example, Inc&quot;.
164 &quot;primaryDomain&quot;: &quot;A String&quot;, # The enterprise&#x27;s primary domain, such as &quot;example.com&quot;.
165}</pre>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700166</div>
167
168<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700169 <code class="details" id="createWebToken">createWebToken(enterpriseId, body=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700170 <pre>Returns a unique token to access an embeddable UI. To generate a web UI, pass the generated token into the managed Google Play javascript API. Each token may only be used to start one UI session. See the javascript API documentation for further information.
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700171
172Args:
173 enterpriseId: string, The ID of the enterprise. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700174 body: object, The request body.
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700175 The object takes the form of:
176
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700177{ # Specification for a token used to generate iframes. The token specifies what data the admin is allowed to modify and the URI the iframe is allowed to communiate with.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800178 &quot;managedConfigurations&quot;: { # Options for displaying the Managed Configuration page.
179 &quot;enabled&quot;: True or False, # Whether the Managed Configuration page is displayed. Default is true.
180 },
181 &quot;parent&quot;: &quot;A String&quot;, # The URI of the parent frame hosting the iframe. To prevent XSS, the iframe may not be hosted at other URIs. This URI must be https. Use whitespaces to separate multiple parent URIs.
182 &quot;permission&quot;: [ # Deprecated. Use PlaySearch.approveApps.
183 &quot;A String&quot;,
184 ],
185 &quot;playSearch&quot;: { # Options for displaying the managed Play Search apps page.
186 &quot;approveApps&quot;: True or False, # Allow access to the iframe in approve mode. Default is false.
187 &quot;enabled&quot;: True or False, # Whether the managed Play Search apps page is displayed. Default is true.
188 },
189 &quot;privateApps&quot;: { # Options for displaying the Private Apps page.
190 &quot;enabled&quot;: True or False, # Whether the Private Apps page is displayed. Default is true.
191 },
192 &quot;storeBuilder&quot;: { # Options for displaying the Organize apps page.
193 &quot;enabled&quot;: True or False, # Whether the Organize apps page is displayed. Default is true.
194 },
195 &quot;webApps&quot;: { # Options for displaying the Web Apps page.
196 &quot;enabled&quot;: True or False, # Whether the Web Apps page is displayed. Default is true.
197 },
yoshi-code-bot44a67192021-05-02 03:48:02 -0700198 &quot;zeroTouch&quot;: { # Options for displaying the Zero Touch page.
199 &quot;enabled&quot;: True or False, # Whether zero-touch embedded UI is usable with this token. If enabled, the admin can link zero-touch customers to this enterprise.
200 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800201}
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700202
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700203 x__xgafv: string, V1 error format.
204 Allowed values
205 1 - v1 error format
206 2 - v2 error format
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700207
208Returns:
209 An object of the form:
210
Sai Cheemalapatic30d2b52017-03-13 12:12:03 -0400211 { # A token authorizing an admin to access an iframe.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800212 &quot;token&quot;: &quot;A String&quot;, # An opaque token to be passed to the Play front-end to generate an iframe.
213}</pre>
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700214</div>
215
216<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700217 <code class="details" id="enroll">enroll(token, body=None, x__xgafv=None)</code>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800218 <pre>Enrolls an enterprise with the calling EMM.
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000219
220Args:
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700221 token: string, Required. The token provided by the enterprise to register the EMM. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700222 body: object, The request body.
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000223 The object takes the form of:
224
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700225{ # An Enterprises resource represents the binding between an EMM and a specific organization. That binding can be instantiated in one of two different ways using this API as follows: - For Google managed domain customers, the process involves using Enterprises.enroll and Enterprises.setAccount (in conjunction with artifacts obtained from the Admin console and the Google API Console) and submitted to the EMM through a more-or-less manual process. - For managed Google Play Accounts customers, the process involves using Enterprises.generateSignupUrl and Enterprises.completeSignup in conjunction with the managed Google Play sign-up UI (Google-provided mechanism) to create the binding without manual steps. As an EMM, you can support either or both approaches in your EMM console. See Create an Enterprise for details.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800226 &quot;administrator&quot;: [ # Admins of the enterprise. This is only supported for enterprises created via the EMM-initiated flow.
227 { # This represents an enterprise admin who can manage the enterprise in the managed Google Play store.
228 &quot;email&quot;: &quot;A String&quot;, # The admin&#x27;s email address.
229 },
230 ],
231 &quot;id&quot;: &quot;A String&quot;, # The unique ID for the enterprise.
232 &quot;name&quot;: &quot;A String&quot;, # The name of the enterprise, for example, &quot;Example, Inc&quot;.
233 &quot;primaryDomain&quot;: &quot;A String&quot;, # The enterprise&#x27;s primary domain, such as &quot;example.com&quot;.
234}
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000235
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700236 x__xgafv: string, V1 error format.
237 Allowed values
238 1 - v1 error format
239 2 - v2 error format
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700240
241Returns:
242 An object of the form:
243
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700244 { # An Enterprises resource represents the binding between an EMM and a specific organization. That binding can be instantiated in one of two different ways using this API as follows: - For Google managed domain customers, the process involves using Enterprises.enroll and Enterprises.setAccount (in conjunction with artifacts obtained from the Admin console and the Google API Console) and submitted to the EMM through a more-or-less manual process. - For managed Google Play Accounts customers, the process involves using Enterprises.generateSignupUrl and Enterprises.completeSignup in conjunction with the managed Google Play sign-up UI (Google-provided mechanism) to create the binding without manual steps. As an EMM, you can support either or both approaches in your EMM console. See Create an Enterprise for details.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800245 &quot;administrator&quot;: [ # Admins of the enterprise. This is only supported for enterprises created via the EMM-initiated flow.
246 { # This represents an enterprise admin who can manage the enterprise in the managed Google Play store.
247 &quot;email&quot;: &quot;A String&quot;, # The admin&#x27;s email address.
248 },
249 ],
250 &quot;id&quot;: &quot;A String&quot;, # The unique ID for the enterprise.
251 &quot;name&quot;: &quot;A String&quot;, # The name of the enterprise, for example, &quot;Example, Inc&quot;.
252 &quot;primaryDomain&quot;: &quot;A String&quot;, # The enterprise&#x27;s primary domain, such as &quot;example.com&quot;.
253}</pre>
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700254</div>
255
256<div class="method">
257 <code class="details" id="generateSignupUrl">generateSignupUrl(callbackUrl=None, x__xgafv=None)</code>
258 <pre>Generates a sign-up URL.
259
260Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700261 callbackUrl: string, The callback URL to which the Admin will be redirected after successfully creating an enterprise. Before redirecting there the system will add a single query parameter to this URL named &quot;enterpriseToken&quot; which will contain an opaque token to be used for the CompleteSignup request. Beware that this means that the URL will be parsed, the parameter added and then a new URL formatted, i.e. there may be some minor formatting changes and, more importantly, the URL must be well-formed so that it can be parsed.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700262 x__xgafv: string, V1 error format.
263 Allowed values
264 1 - v1 error format
265 2 - v2 error format
266
267Returns:
268 An object of the form:
269
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700270 { # A resource returned by the GenerateSignupUrl API, which contains the Signup URL and Completion Token.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800271 &quot;completionToken&quot;: &quot;A String&quot;, # An opaque token that will be required, along with the Enterprise Token, for obtaining the enterprise resource from CompleteSignup.
272 &quot;kind&quot;: &quot;A String&quot;, # Deprecated.
273 &quot;url&quot;: &quot;A String&quot;, # A URL under which the Admin can sign up for an enterprise. The page pointed to cannot be rendered in an iframe.
274}</pre>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700275</div>
276
277<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700278 <code class="details" id="get">get(enterpriseId, x__xgafv=None)</code>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000279 <pre>Retrieves the name and domain of an enterprise.
280
281Args:
282 enterpriseId: string, The ID of the enterprise. (required)
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700283 x__xgafv: string, V1 error format.
284 Allowed values
285 1 - v1 error format
286 2 - v2 error format
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000287
288Returns:
289 An object of the form:
290
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700291 { # An Enterprises resource represents the binding between an EMM and a specific organization. That binding can be instantiated in one of two different ways using this API as follows: - For Google managed domain customers, the process involves using Enterprises.enroll and Enterprises.setAccount (in conjunction with artifacts obtained from the Admin console and the Google API Console) and submitted to the EMM through a more-or-less manual process. - For managed Google Play Accounts customers, the process involves using Enterprises.generateSignupUrl and Enterprises.completeSignup in conjunction with the managed Google Play sign-up UI (Google-provided mechanism) to create the binding without manual steps. As an EMM, you can support either or both approaches in your EMM console. See Create an Enterprise for details.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800292 &quot;administrator&quot;: [ # Admins of the enterprise. This is only supported for enterprises created via the EMM-initiated flow.
293 { # This represents an enterprise admin who can manage the enterprise in the managed Google Play store.
294 &quot;email&quot;: &quot;A String&quot;, # The admin&#x27;s email address.
295 },
296 ],
297 &quot;id&quot;: &quot;A String&quot;, # The unique ID for the enterprise.
298 &quot;name&quot;: &quot;A String&quot;, # The name of the enterprise, for example, &quot;Example, Inc&quot;.
299 &quot;primaryDomain&quot;: &quot;A String&quot;, # The enterprise&#x27;s primary domain, such as &quot;example.com&quot;.
300}</pre>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000301</div>
302
303<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700304 <code class="details" id="getServiceAccount">getServiceAccount(enterpriseId, keyType=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700305 <pre>Returns a service account and credentials. The service account can be bound to the enterprise by calling setAccount. The service account is unique to this enterprise and EMM, and will be deleted if the enterprise is unbound. The credentials contain private key data and are not stored server-side. This method can only be called after calling Enterprises.Enroll or Enterprises.CompleteSignup, and before Enterprises.SetAccount; at other times it will return an error. Subsequent calls after the first will generate a new, unique set of credentials, and invalidate the previously generated credentials. Once the service account is bound to the enterprise, it can be managed using the serviceAccountKeys resource.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700306
307Args:
308 enterpriseId: string, The ID of the enterprise. (required)
309 keyType: string, The type of credential to return with the service account. Required.
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700310 Allowed values
311 googleCredentials - Google Credentials File format.
312 pkcs12 - PKCS12 format. The password for the PKCS12 file is &#x27;notasecret&#x27;. For more information, see https://tools.ietf.org/html/rfc7292. The data for keys of this type are base64 encoded according to RFC 4648 Section 4. See http://tools.ietf.org/html/rfc4648#section-4.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700313 x__xgafv: string, V1 error format.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700314 Allowed values
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700315 1 - v1 error format
316 2 - v2 error format
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700317
318Returns:
319 An object of the form:
320
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700321 { # A service account identity, including the name and credentials that can be used to authenticate as the service account.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800322 &quot;key&quot;: { # Credentials that can be used to authenticate as a service account. # Credentials that can be used to authenticate as this ServiceAccount.
323 &quot;data&quot;: &quot;A String&quot;, # The body of the private key credentials file, in string format. This is only populated when the ServiceAccountKey is created, and is not stored by Google.
324 &quot;id&quot;: &quot;A String&quot;, # An opaque, unique identifier for this ServiceAccountKey. Assigned by the server.
325 &quot;publicData&quot;: &quot;A String&quot;, # Public key data for the credentials file. This is an X.509 cert. If you are using the googleCredentials key type, this is identical to the cert that can be retrieved by using the X.509 cert url inside of the credentials file.
326 &quot;type&quot;: &quot;A String&quot;, # The file format of the generated key data.
327 },
328 &quot;name&quot;: &quot;A String&quot;, # The account name of the service account, in the form of an email address. Assigned by the server.
329}</pre>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700330</div>
331
332<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700333 <code class="details" id="getStoreLayout">getStoreLayout(enterpriseId, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700334 <pre>Returns the store layout for the enterprise. If the store layout has not been set, returns &quot;basic&quot; as the store layout type and no homepage.
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000335
336Args:
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800337 enterpriseId: string, The ID of the enterprise. (required)
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700338 x__xgafv: string, V1 error format.
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700339 Allowed values
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700340 1 - v1 error format
341 2 - v2 error format
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700342
343Returns:
344 An object of the form:
345
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700346 { # General setting for the managed Google Play store layout, currently only specifying the page to display the first time the store is opened.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800347 &quot;homepageId&quot;: &quot;A String&quot;, # The ID of the store page to be used as the homepage. The homepage is the first page shown in the managed Google Play Store. Not specifying a homepage is equivalent to setting the store layout type to &quot;basic&quot;.
348 &quot;storeLayoutType&quot;: &quot;A String&quot;, # The store layout type. By default, this value is set to &quot;basic&quot; if the homepageId field is not set, and to &quot;custom&quot; otherwise. If set to &quot;basic&quot;, the layout will consist of all approved apps that have been whitelisted for the user.
349}</pre>
Jon Wayne Parrott7d5badb2016-08-16 12:44:29 -0700350</div>
351
352<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700353 <code class="details" id="list">list(domain, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700354 <pre>Looks up an enterprise by domain name. This is only supported for enterprises created via the Google-initiated creation flow. Lookup of the id is not needed for enterprises created via the EMM-initiated flow since the EMM learns the enterprise ID in the callback specified in the Enterprises.generateSignupUrl call.
Takashi Matsuo06694102015-09-11 13:55:40 -0700355
356Args:
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700357 domain: string, Required. The exact primary domain name of the enterprise to look up. (required)
358 x__xgafv: string, V1 error format.
359 Allowed values
360 1 - v1 error format
361 2 - v2 error format
Takashi Matsuo06694102015-09-11 13:55:40 -0700362
363Returns:
364 An object of the form:
365
366 {
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800367 &quot;enterprise&quot;: [ # An enterprise.
368 { # An Enterprises resource represents the binding between an EMM and a specific organization. That binding can be instantiated in one of two different ways using this API as follows: - For Google managed domain customers, the process involves using Enterprises.enroll and Enterprises.setAccount (in conjunction with artifacts obtained from the Admin console and the Google API Console) and submitted to the EMM through a more-or-less manual process. - For managed Google Play Accounts customers, the process involves using Enterprises.generateSignupUrl and Enterprises.completeSignup in conjunction with the managed Google Play sign-up UI (Google-provided mechanism) to create the binding without manual steps. As an EMM, you can support either or both approaches in your EMM console. See Create an Enterprise for details.
369 &quot;administrator&quot;: [ # Admins of the enterprise. This is only supported for enterprises created via the EMM-initiated flow.
370 { # This represents an enterprise admin who can manage the enterprise in the managed Google Play store.
371 &quot;email&quot;: &quot;A String&quot;, # The admin&#x27;s email address.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800372 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800373 ],
374 &quot;id&quot;: &quot;A String&quot;, # The unique ID for the enterprise.
375 &quot;name&quot;: &quot;A String&quot;, # The name of the enterprise, for example, &quot;Example, Inc&quot;.
376 &quot;primaryDomain&quot;: &quot;A String&quot;, # The enterprise&#x27;s primary domain, such as &quot;example.com&quot;.
377 },
378 ],
379}</pre>
Takashi Matsuo06694102015-09-11 13:55:40 -0700380</div>
381
382<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700383 <code class="details" id="pullNotificationSet">pullNotificationSet(requestMode=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700384 <pre>Pulls and returns a notification set for the enterprises associated with the service account authenticated for the request. The notification set may be empty if no notification are pending. A notification set returned needs to be acknowledged within 20 seconds by calling Enterprises.AcknowledgeNotificationSet, unless the notification set is empty. Notifications that are not acknowledged within the 20 seconds will eventually be included again in the response to another PullNotificationSet request, and those that are never acknowledged will ultimately be deleted according to the Google Cloud Platform Pub/Sub system policy. Multiple requests might be performed concurrently to retrieve notifications, in which case the pending notifications (if any) will be split among each caller, if any are pending. If no notifications are present, an empty notification list is returned. Subsequent requests may return more notifications once they become available.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700385
386Args:
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700387 requestMode: string, The request mode for pulling notifications. Specifying waitForNotifications will cause the request to block and wait until one or more notifications are present, or return an empty notification list if no notifications are present after some time. Speciying returnImmediately will cause the request to immediately return the pending notifications, or an empty list if no notifications are present. If omitted, defaults to waitForNotifications.
388 Allowed values
389 waitForNotifications - Wait until one or more notifications are present.
390 returnImmediately - Returns immediately whether notifications are present or not.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700391 x__xgafv: string, V1 error format.
392 Allowed values
393 1 - v1 error format
394 2 - v2 error format
395
396Returns:
397 An object of the form:
398
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700399 { # A resource returned by the PullNotificationSet API, which contains a collection of notifications for enterprises associated with the service account authenticated for the request.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800400 &quot;notification&quot;: [ # The notifications received, or empty if no notifications are present.
401 { # A notification of one event relating to an enterprise.
402 &quot;appRestrictionsSchemaChangeEvent&quot;: { # An event generated when a new app version is uploaded to Google Play and its app restrictions schema changed. To fetch the app restrictions schema for an app, use Products.getAppRestrictionsSchema on the EMM API. # Notifications about new app restrictions schema changes.
403 &quot;productId&quot;: &quot;A String&quot;, # The id of the product (e.g. &quot;app:com.google.android.gm&quot;) for which the app restriction schema changed. This field will always be present.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700404 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800405 &quot;appUpdateEvent&quot;: { # An event generated when a new version of an app is uploaded to Google Play. Notifications are sent for new public versions only: alpha, beta, or canary versions do not generate this event. To fetch up-to-date version history for an app, use Products.Get on the EMM API. # Notifications about app updates.
406 &quot;productId&quot;: &quot;A String&quot;, # The id of the product (e.g. &quot;app:com.google.android.gm&quot;) that was updated. This field will always be present.
407 },
408 &quot;deviceReportUpdateEvent&quot;: { # An event generated when an updated device report is available. # Notifications about device report updates.
409 &quot;deviceId&quot;: &quot;A String&quot;, # The Android ID of the device. This field will always be present.
410 &quot;report&quot;: { # Device report updated with the latest app states for managed apps on the device. # The device report updated with the latest app states. This field will always be present.
411 &quot;appState&quot;: [ # List of app states set by managed apps on the device. App states are defined by the app&#x27;s developers. This field will always be present.
412 { # List of states set by the app.
413 &quot;keyedAppState&quot;: [ # List of keyed app states. This field will always be present.
414 { # Represents a keyed app state containing a key, timestamp, severity level, optional description, and optional data.
415 &quot;data&quot;: &quot;A String&quot;, # Additional field intended for machine-readable data. For example, a number or JSON object. To prevent XSS, we recommend removing any HTML from the data before displaying it.
416 &quot;key&quot;: &quot;A String&quot;, # Key indicating what the app is providing a state for. The content of the key is set by the app&#x27;s developer. To prevent XSS, we recommend removing any HTML from the key before displaying it. This field will always be present.
417 &quot;message&quot;: &quot;A String&quot;, # Free-form, human-readable message describing the app state. For example, an error message. To prevent XSS, we recommend removing any HTML from the message before displaying it.
418 &quot;severity&quot;: &quot;A String&quot;, # Severity of the app state. This field will always be present.
419 &quot;stateTimestampMillis&quot;: &quot;A String&quot;, # Timestamp of when the app set the state in milliseconds since epoch. This field will always be present.
420 },
421 ],
422 &quot;packageName&quot;: &quot;A String&quot;, # The package name of the app. This field will always be present.
423 },
424 ],
425 &quot;lastUpdatedTimestampMillis&quot;: &quot;A String&quot;, # The timestamp of the last report update in milliseconds since epoch. This field will always be present.
426 },
427 &quot;userId&quot;: &quot;A String&quot;, # The ID of the user. This field will always be present.
428 },
429 &quot;enterpriseId&quot;: &quot;A String&quot;, # The ID of the enterprise for which the notification is sent. This will always be present.
430 &quot;installFailureEvent&quot;: { # An event generated when an app installation failed on a device # Notifications about an app installation failure.
431 &quot;deviceId&quot;: &quot;A String&quot;, # The Android ID of the device. This field will always be present.
432 &quot;failureDetails&quot;: &quot;A String&quot;, # Additional details on the failure if applicable.
433 &quot;failureReason&quot;: &quot;A String&quot;, # The reason for the installation failure. This field will always be present.
434 &quot;productId&quot;: &quot;A String&quot;, # The id of the product (e.g. &quot;app:com.google.android.gm&quot;) for which the install failure event occured. This field will always be present.
435 &quot;userId&quot;: &quot;A String&quot;, # The ID of the user. This field will always be present.
436 },
437 &quot;newDeviceEvent&quot;: { # An event generated when a new device is ready to be managed. # Notifications about new devices.
438 &quot;deviceId&quot;: &quot;A String&quot;, # The Android ID of the device. This field will always be present.
439 &quot;dpcPackageName&quot;: &quot;A String&quot;, # Policy app on the device.
440 &quot;managementType&quot;: &quot;A String&quot;, # Identifies the extent to which the device is controlled by an Android EMM in various deployment configurations. Possible values include: - &quot;managedDevice&quot;, a device where the DPC is set as device owner, - &quot;managedProfile&quot;, a device where the DPC is set as profile owner.
441 &quot;userId&quot;: &quot;A String&quot;, # The ID of the user. This field will always be present.
442 },
443 &quot;newPermissionsEvent&quot;: { # An event generated when new permissions are added to an app. # Notifications about new app permissions.
444 &quot;approvedPermissions&quot;: [ # The set of permissions that the enterprise admin has already approved for this application. Use Permissions.Get on the EMM API to retrieve details about these permissions.
445 &quot;A String&quot;,
446 ],
447 &quot;productId&quot;: &quot;A String&quot;, # The id of the product (e.g. &quot;app:com.google.android.gm&quot;) for which new permissions were added. This field will always be present.
448 &quot;requestedPermissions&quot;: [ # The set of permissions that the app is currently requesting. Use Permissions.Get on the EMM API to retrieve details about these permissions.
449 &quot;A String&quot;,
450 ],
451 },
452 &quot;notificationType&quot;: &quot;A String&quot;, # Type of the notification.
453 &quot;productApprovalEvent&quot;: { # An event generated when a product&#x27;s approval status is changed. # Notifications about changes to a product&#x27;s approval status.
454 &quot;approved&quot;: &quot;A String&quot;, # Whether the product was approved or unapproved. This field will always be present.
455 &quot;productId&quot;: &quot;A String&quot;, # The id of the product (e.g. &quot;app:com.google.android.gm&quot;) for which the approval status has changed. This field will always be present.
456 },
457 &quot;productAvailabilityChangeEvent&quot;: { # An event generated whenever a product&#x27;s availability changes. # Notifications about product availability changes.
458 &quot;availabilityStatus&quot;: &quot;A String&quot;, # The new state of the product. This field will always be present.
459 &quot;productId&quot;: &quot;A String&quot;, # The id of the product (e.g. &quot;app:com.google.android.gm&quot;) for which the product availability changed. This field will always be present.
460 },
461 &quot;timestampMillis&quot;: &quot;A String&quot;, # The time when the notification was published in milliseconds since 1970-01-01T00:00:00Z. This will always be present.
462 },
463 ],
464 &quot;notificationSetId&quot;: &quot;A String&quot;, # The notification set ID, required to mark the notification as received with the Enterprises.AcknowledgeNotification API. This will be omitted if no notifications are present.
465}</pre>
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700466</div>
467
468<div class="method">
469 <code class="details" id="sendTestPushNotification">sendTestPushNotification(enterpriseId, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700470 <pre>Sends a test notification to validate the EMM integration with the Google Cloud Pub/Sub service for this enterprise.
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700471
472Args:
473 enterpriseId: string, The ID of the enterprise. (required)
474 x__xgafv: string, V1 error format.
475 Allowed values
476 1 - v1 error format
477 2 - v2 error format
478
479Returns:
480 An object of the form:
481
482 {
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800483 &quot;messageId&quot;: &quot;A String&quot;, # The message ID of the test push notification that was sent.
484 &quot;topicName&quot;: &quot;A String&quot;, # The name of the Cloud Pub/Sub topic to which notifications for this enterprise&#x27;s enrolled account will be sent.
485}</pre>
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700486</div>
487
488<div class="method">
489 <code class="details" id="setAccount">setAccount(enterpriseId, body=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700490 <pre>Sets the account that will be used to authenticate to the API as the enterprise.
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000491
492Args:
493 enterpriseId: string, The ID of the enterprise. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700494 body: object, The request body.
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000495 The object takes the form of:
496
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700497{ # A service account that can be used to authenticate as the enterprise to API calls that require such authentication.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800498 &quot;accountEmail&quot;: &quot;A String&quot;, # The email address of the service account.
499}
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000500
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700501 x__xgafv: string, V1 error format.
502 Allowed values
503 1 - v1 error format
504 2 - v2 error format
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000505
506Returns:
507 An object of the form:
508
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700509 { # A service account that can be used to authenticate as the enterprise to API calls that require such authentication.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800510 &quot;accountEmail&quot;: &quot;A String&quot;, # The email address of the service account.
511}</pre>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000512</div>
513
514<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700515 <code class="details" id="setStoreLayout">setStoreLayout(enterpriseId, body=None, x__xgafv=None)</code>
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700516 <pre>Sets the store layout for the enterprise. By default, storeLayoutType is set to &quot;basic&quot; and the basic store layout is enabled. The basic layout only contains apps approved by the admin, and that have been added to the available product set for a user (using the setAvailableProductSet call). Apps on the page are sorted in order of their product ID value. If you create a custom store layout (by setting storeLayoutType = &quot;custom&quot; and setting a homepage), the basic store layout is disabled.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800517
518Args:
519 enterpriseId: string, The ID of the enterprise. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700520 body: object, The request body.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800521 The object takes the form of:
522
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700523{ # General setting for the managed Google Play store layout, currently only specifying the page to display the first time the store is opened.
Yoshi Automation Bot0bf565c2020-12-09 08:56:03 -0800524 &quot;homepageId&quot;: &quot;A String&quot;, # The ID of the store page to be used as the homepage. The homepage is the first page shown in the managed Google Play Store. Not specifying a homepage is equivalent to setting the store layout type to &quot;basic&quot;.
525 &quot;storeLayoutType&quot;: &quot;A String&quot;, # The store layout type. By default, this value is set to &quot;basic&quot; if the homepageId field is not set, and to &quot;custom&quot; otherwise. If set to &quot;basic&quot;, the layout will consist of all approved apps that have been whitelisted for the user.
526}
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800527
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700528 x__xgafv: string, V1 error format.
529 Allowed values
530 1 - v1 error format
531 2 - v2 error format
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800532
533Returns:
534 An object of the form:
535
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700536 { # General setting for the managed Google Play store layout, currently only specifying the page to display the first time the store is opened.
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800537 &quot;homepageId&quot;: &quot;A String&quot;, # The ID of the store page to be used as the homepage. The homepage is the first page shown in the managed Google Play Store. Not specifying a homepage is equivalent to setting the store layout type to &quot;basic&quot;.
538 &quot;storeLayoutType&quot;: &quot;A String&quot;, # The store layout type. By default, this value is set to &quot;basic&quot; if the homepageId field is not set, and to &quot;custom&quot; otherwise. If set to &quot;basic&quot;, the layout will consist of all approved apps that have been whitelisted for the user.
539}</pre>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800540</div>
541
542<div class="method">
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700543 <code class="details" id="unenroll">unenroll(enterpriseId, x__xgafv=None)</code>
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800544 <pre>Unenrolls an enterprise from the calling EMM.
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000545
546Args:
547 enterpriseId: string, The ID of the enterprise. (required)
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700548 x__xgafv: string, V1 error format.
549 Allowed values
550 1 - v1 error format
551 2 - v2 error format
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000552</pre>
553</div>
554
555</body></html>