blob: a8d60996b7e50898bc1a82941818870905ca305a [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001<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
75<h1><a href="androiddeviceprovisioning_v1.html">Android Device Provisioning Partner API</a> . <a href="androiddeviceprovisioning_v1.customers.html">customers</a> . <a href="androiddeviceprovisioning_v1.customers.configurations.html">configurations</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070078 <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070079<p class="firstline">Creates a new configuration. Once created, a customer can apply the</p>
80<p class="toc_element">
81 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
82<p class="firstline">Deletes an unused configuration. The API call fails if the customer has</p>
83<p class="toc_element">
84 <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
85<p class="firstline">Gets the details of a configuration.</p>
86<p class="toc_element">
87 <code><a href="#list">list(parent, x__xgafv=None)</a></code></p>
88<p class="firstline">Lists a customer's configurations.</p>
89<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070090 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070091<p class="firstline">Updates a configuration's field values.</p>
92<h3>Method Details</h3>
93<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -070094 <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070095 <pre>Creates a new configuration. Once created, a customer can apply the
96configuration to devices.
97
98Args:
99 parent: string, Required. The customer that manages the configuration. An API resource name
100in the format `customers/[CUSTOMER_ID]`. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700101 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700102 The object takes the form of:
103
104{ # A configuration collects the provisioning options for Android devices. Each
105 # configuration combines the following:
106 #
107 # * The EMM device policy controller (DPC) installed on the devices.
108 # * EMM policies enforced on the devices.
109 # * Metadata displayed on the device to help users during setup.
110 #
111 # Customers can add as many configurations as they need. However, zero-touch
Bu Sun Kim65020912020-05-20 12:08:20 -0700112 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700113 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700114 &quot;customMessage&quot;: &quot;A String&quot;, # A message, containing one or two sentences, to help device users get help
115 # or give them more details about what’s happening to their device.
116 # Zero-touch enrollment shows this message before the device is provisioned.
Bu Sun Kim65020912020-05-20 12:08:20 -0700117 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
118 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
119 # portal displays this name to IT admins.
120 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
121 # Zero-touch enrollment shows this email address to device users before
122 # device provisioning. The value is validated on input.
Bu Sun Kim65020912020-05-20 12:08:20 -0700123 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700124 # enrollment applies to any new devices the organization purchases in the
125 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700126 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700127 # value to `false`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700128 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700129 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
130 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
131 # the server.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700132 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
133 # device, to get help. Zero-touch enrollment shows this number to device
134 # users before device provisioning. Accepts numerals, spaces, the plus sign,
135 # hyphens, and parentheses.
136 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
137 # organization name to device users during device provisioning.
138 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
139 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
140 # call
141 # `customers.dpcs.list`.
142 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700143 }
144
145 x__xgafv: string, V1 error format.
146 Allowed values
147 1 - v1 error format
148 2 - v2 error format
149
150Returns:
151 An object of the form:
152
153 { # A configuration collects the provisioning options for Android devices. Each
154 # configuration combines the following:
155 #
156 # * The EMM device policy controller (DPC) installed on the devices.
157 # * EMM policies enforced on the devices.
158 # * Metadata displayed on the device to help users during setup.
159 #
160 # Customers can add as many configurations as they need. However, zero-touch
Bu Sun Kim65020912020-05-20 12:08:20 -0700161 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700162 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700163 &quot;customMessage&quot;: &quot;A String&quot;, # A message, containing one or two sentences, to help device users get help
164 # or give them more details about what’s happening to their device.
165 # Zero-touch enrollment shows this message before the device is provisioned.
Bu Sun Kim65020912020-05-20 12:08:20 -0700166 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
167 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
168 # portal displays this name to IT admins.
169 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
170 # Zero-touch enrollment shows this email address to device users before
171 # device provisioning. The value is validated on input.
Bu Sun Kim65020912020-05-20 12:08:20 -0700172 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700173 # enrollment applies to any new devices the organization purchases in the
174 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700175 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700176 # value to `false`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700177 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700178 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
179 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
180 # the server.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700181 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
182 # device, to get help. Zero-touch enrollment shows this number to device
183 # users before device provisioning. Accepts numerals, spaces, the plus sign,
184 # hyphens, and parentheses.
185 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
186 # organization name to device users during device provisioning.
187 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
188 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
189 # call
190 # `customers.dpcs.list`.
191 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700192 }</pre>
193</div>
194
195<div class="method">
196 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
197 <pre>Deletes an unused configuration. The API call fails if the customer has
198devices with the configuration applied.
199
200Args:
201 name: string, Required. The configuration to delete. An API resource name in the format
202`customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. If the
203configuration is applied to any devices, the API call fails. (required)
204 x__xgafv: string, V1 error format.
205 Allowed values
206 1 - v1 error format
207 2 - v2 error format
208
209Returns:
210 An object of the form:
211
212 { # A generic empty message that you can re-use to avoid defining duplicated
213 # empty messages in your APIs. A typical example is to use it as the request
214 # or the response type of an API method. For instance:
215 #
216 # service Foo {
217 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
218 # }
219 #
220 # The JSON representation for `Empty` is empty JSON object `{}`.
221 }</pre>
222</div>
223
224<div class="method">
225 <code class="details" id="get">get(name, x__xgafv=None)</code>
226 <pre>Gets the details of a configuration.
227
228Args:
229 name: string, Required. The configuration to get. An API resource name in the format
230`customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. (required)
231 x__xgafv: string, V1 error format.
232 Allowed values
233 1 - v1 error format
234 2 - v2 error format
235
236Returns:
237 An object of the form:
238
239 { # A configuration collects the provisioning options for Android devices. Each
240 # configuration combines the following:
241 #
242 # * The EMM device policy controller (DPC) installed on the devices.
243 # * EMM policies enforced on the devices.
244 # * Metadata displayed on the device to help users during setup.
245 #
246 # Customers can add as many configurations as they need. However, zero-touch
Bu Sun Kim65020912020-05-20 12:08:20 -0700247 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700248 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700249 &quot;customMessage&quot;: &quot;A String&quot;, # A message, containing one or two sentences, to help device users get help
250 # or give them more details about what’s happening to their device.
251 # Zero-touch enrollment shows this message before the device is provisioned.
Bu Sun Kim65020912020-05-20 12:08:20 -0700252 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
253 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
254 # portal displays this name to IT admins.
255 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
256 # Zero-touch enrollment shows this email address to device users before
257 # device provisioning. The value is validated on input.
Bu Sun Kim65020912020-05-20 12:08:20 -0700258 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700259 # enrollment applies to any new devices the organization purchases in the
260 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700261 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700262 # value to `false`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700263 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700264 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
265 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
266 # the server.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700267 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
268 # device, to get help. Zero-touch enrollment shows this number to device
269 # users before device provisioning. Accepts numerals, spaces, the plus sign,
270 # hyphens, and parentheses.
271 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
272 # organization name to device users during device provisioning.
273 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
274 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
275 # call
276 # `customers.dpcs.list`.
277 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700278 }</pre>
279</div>
280
281<div class="method">
282 <code class="details" id="list">list(parent, x__xgafv=None)</code>
Bu Sun Kim65020912020-05-20 12:08:20 -0700283 <pre>Lists a customer&#x27;s configurations.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700284
285Args:
286 parent: string, Required. The customer that manages the listed configurations. An API
287resource name in the format `customers/[CUSTOMER_ID]`. (required)
288 x__xgafv: string, V1 error format.
289 Allowed values
290 1 - v1 error format
291 2 - v2 error format
292
293Returns:
294 An object of the form:
295
Bu Sun Kim65020912020-05-20 12:08:20 -0700296 { # Response message of customer&#x27;s listing configuration.
297 &quot;configurations&quot;: [ # The configurations.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700298 { # A configuration collects the provisioning options for Android devices. Each
299 # configuration combines the following:
300 #
301 # * The EMM device policy controller (DPC) installed on the devices.
302 # * EMM policies enforced on the devices.
303 # * Metadata displayed on the device to help users during setup.
304 #
305 # Customers can add as many configurations as they need. However, zero-touch
Bu Sun Kim65020912020-05-20 12:08:20 -0700306 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700307 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700308 &quot;customMessage&quot;: &quot;A String&quot;, # A message, containing one or two sentences, to help device users get help
309 # or give them more details about what’s happening to their device.
310 # Zero-touch enrollment shows this message before the device is provisioned.
Bu Sun Kim65020912020-05-20 12:08:20 -0700311 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
312 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
313 # portal displays this name to IT admins.
314 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
315 # Zero-touch enrollment shows this email address to device users before
316 # device provisioning. The value is validated on input.
Bu Sun Kim65020912020-05-20 12:08:20 -0700317 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700318 # enrollment applies to any new devices the organization purchases in the
319 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700320 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700321 # value to `false`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700322 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700323 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
324 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
325 # the server.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700326 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
327 # device, to get help. Zero-touch enrollment shows this number to device
328 # users before device provisioning. Accepts numerals, spaces, the plus sign,
329 # hyphens, and parentheses.
330 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
331 # organization name to device users during device provisioning.
332 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
333 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
334 # call
335 # `customers.dpcs.list`.
336 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700337 },
338 ],
339 }</pre>
340</div>
341
342<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700343 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
Bu Sun Kim65020912020-05-20 12:08:20 -0700344 <pre>Updates a configuration&#x27;s field values.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700345
346Args:
347 name: string, Output only. The API resource name in the format
348`customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
349the server. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700350 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700351 The object takes the form of:
352
353{ # A configuration collects the provisioning options for Android devices. Each
354 # configuration combines the following:
355 #
356 # * The EMM device policy controller (DPC) installed on the devices.
357 # * EMM policies enforced on the devices.
358 # * Metadata displayed on the device to help users during setup.
359 #
360 # Customers can add as many configurations as they need. However, zero-touch
Bu Sun Kim65020912020-05-20 12:08:20 -0700361 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700362 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700363 &quot;customMessage&quot;: &quot;A String&quot;, # A message, containing one or two sentences, to help device users get help
364 # or give them more details about what’s happening to their device.
365 # Zero-touch enrollment shows this message before the device is provisioned.
Bu Sun Kim65020912020-05-20 12:08:20 -0700366 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
367 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
368 # portal displays this name to IT admins.
369 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
370 # Zero-touch enrollment shows this email address to device users before
371 # device provisioning. The value is validated on input.
Bu Sun Kim65020912020-05-20 12:08:20 -0700372 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700373 # enrollment applies to any new devices the organization purchases in the
374 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700375 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700376 # value to `false`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700377 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700378 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
379 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
380 # the server.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700381 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
382 # device, to get help. Zero-touch enrollment shows this number to device
383 # users before device provisioning. Accepts numerals, spaces, the plus sign,
384 # hyphens, and parentheses.
385 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
386 # organization name to device users during device provisioning.
387 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
388 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
389 # call
390 # `customers.dpcs.list`.
391 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700392 }
393
394 updateMask: string, Required. The field mask applied to the target `Configuration` before
395updating the fields. To learn more about using field masks, read
396[FieldMask](/protocol-buffers/docs/reference/google.protobuf#fieldmask) in
397the Protocol Buffers documentation.
398 x__xgafv: string, V1 error format.
399 Allowed values
400 1 - v1 error format
401 2 - v2 error format
402
403Returns:
404 An object of the form:
405
406 { # A configuration collects the provisioning options for Android devices. Each
407 # configuration combines the following:
408 #
409 # * The EMM device policy controller (DPC) installed on the devices.
410 # * EMM policies enforced on the devices.
411 # * Metadata displayed on the device to help users during setup.
412 #
413 # Customers can add as many configurations as they need. However, zero-touch
Bu Sun Kim65020912020-05-20 12:08:20 -0700414 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700415 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700416 &quot;customMessage&quot;: &quot;A String&quot;, # A message, containing one or two sentences, to help device users get help
417 # or give them more details about what’s happening to their device.
418 # Zero-touch enrollment shows this message before the device is provisioned.
Bu Sun Kim65020912020-05-20 12:08:20 -0700419 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
420 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
421 # portal displays this name to IT admins.
422 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
423 # Zero-touch enrollment shows this email address to device users before
424 # device provisioning. The value is validated on input.
Bu Sun Kim65020912020-05-20 12:08:20 -0700425 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700426 # enrollment applies to any new devices the organization purchases in the
427 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700428 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700429 # value to `false`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700430 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700431 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
432 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
433 # the server.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700434 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
435 # device, to get help. Zero-touch enrollment shows this number to device
436 # users before device provisioning. Accepts numerals, spaces, the plus sign,
437 # hyphens, and parentheses.
438 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
439 # organization name to device users during device provisioning.
440 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
441 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
442 # call
443 # `customers.dpcs.list`.
444 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700445 }</pre>
446</div>
447
448</body></html>