Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / b8458c0b73030155b64a3c2392b2f70e5fbc3baf / . / docs / dyn / androiddeviceprovisioning_v1.customers.configurations.html
blob: 0cce351c6a6a829a3a39eca37a5f8a1f60a8170b [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]1<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 -0700[diff] [blame]78 <code><a href="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]79<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 -0700[diff] [blame]90 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]91<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 -0700[diff] [blame]94 <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]95 <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 -0700[diff] [blame]101 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]102 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 -0700[diff] [blame]112 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]113 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]114 &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.
117 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
118 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
119 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
120 # portal displays this name to IT admins.
121 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
122 # Zero-touch enrollment shows this email address to device users before
123 # device provisioning. The value is validated on input.
124 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]125 # device, to get help. Zero-touch enrollment shows this number to device
126 # users before device provisioning. Accepts numerals, spaces, the plus sign,
127 # hyphens, and parentheses.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]128 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]129 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
130 # call
131 # `customers.dpcs.list`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]132 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
133 # organization name to device users during device provisioning.
134 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]135 # enrollment applies to any new devices the organization purchases in the
136 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]137 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]138 # value to `false`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]139 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
140 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
141 # the server.
142 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]143 }
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 -0700[diff] [blame]161 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]162 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]163 &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.
166 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
167 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
168 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
169 # portal displays this name to IT admins.
170 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
171 # Zero-touch enrollment shows this email address to device users before
172 # device provisioning. The value is validated on input.
173 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]174 # device, to get help. Zero-touch enrollment shows this number to device
175 # users before device provisioning. Accepts numerals, spaces, the plus sign,
176 # hyphens, and parentheses.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]177 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]178 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
179 # call
180 # `customers.dpcs.list`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]181 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
182 # organization name to device users during device provisioning.
183 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]184 # enrollment applies to any new devices the organization purchases in the
185 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]186 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]187 # value to `false`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]188 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
189 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
190 # the server.
191 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]192 }</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 -0700[diff] [blame]247 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]248 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]249 &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.
252 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
253 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
254 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
255 # portal displays this name to IT admins.
256 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
257 # Zero-touch enrollment shows this email address to device users before
258 # device provisioning. The value is validated on input.
259 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]260 # device, to get help. Zero-touch enrollment shows this number to device
261 # users before device provisioning. Accepts numerals, spaces, the plus sign,
262 # hyphens, and parentheses.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]263 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]264 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
265 # call
266 # `customers.dpcs.list`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]267 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
268 # organization name to device users during device provisioning.
269 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]270 # enrollment applies to any new devices the organization purchases in the
271 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]272 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]273 # value to `false`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]274 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
275 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
276 # the server.
277 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]278 }</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 -0700[diff] [blame]283 <pre>Lists a customer&#x27;s configurations.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]284
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 -0700[diff] [blame]296 { # Response message of customer&#x27;s listing configuration.
297 &quot;configurations&quot;: [ # The configurations.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]298 { # 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 -0700[diff] [blame]306 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]307 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]308 &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.
311 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
312 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
313 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
314 # portal displays this name to IT admins.
315 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
316 # Zero-touch enrollment shows this email address to device users before
317 # device provisioning. The value is validated on input.
318 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]319 # device, to get help. Zero-touch enrollment shows this number to device
320 # users before device provisioning. Accepts numerals, spaces, the plus sign,
321 # hyphens, and parentheses.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]322 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]323 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
324 # call
325 # `customers.dpcs.list`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]326 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
327 # organization name to device users during device provisioning.
328 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]329 # enrollment applies to any new devices the organization purchases in the
330 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]331 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]332 # value to `false`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]333 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
334 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
335 # the server.
336 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]337 },
338 ],
339 }</pre>
340</div>
341
342<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]343 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]344 <pre>Updates a configuration&#x27;s field values.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]345
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 -0700[diff] [blame]350 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]351 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 -0700[diff] [blame]361 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]362 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]363 &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.
366 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
367 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
368 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
369 # portal displays this name to IT admins.
370 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
371 # Zero-touch enrollment shows this email address to device users before
372 # device provisioning. The value is validated on input.
373 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]374 # device, to get help. Zero-touch enrollment shows this number to device
375 # users before device provisioning. Accepts numerals, spaces, the plus sign,
376 # hyphens, and parentheses.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]377 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]378 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
379 # call
380 # `customers.dpcs.list`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]381 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
382 # organization name to device users during device provisioning.
383 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]384 # enrollment applies to any new devices the organization purchases in the
385 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]386 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]387 # value to `false`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]388 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
389 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
390 # the server.
391 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]392 }
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 -0700[diff] [blame]414 # enrollment works best when a customer sets a default configuration that&#x27;s
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]415 # applied to any new devices the organization purchases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]416 &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.
419 &quot;dpcExtras&quot;: &quot;A String&quot;, # The JSON-formatted EMM provisioning extras that are passed to the DPC.
420 &quot;configurationName&quot;: &quot;A String&quot;, # Required. A short name that describes the configuration&#x27;s purpose. For
421 # example, _Sales team_ or _Temporary employees_. The zero-touch enrollment
422 # portal displays this name to IT admins.
423 &quot;contactEmail&quot;: &quot;A String&quot;, # Required. The email address that device users can contact to get help.
424 # Zero-touch enrollment shows this email address to device users before
425 # device provisioning. The value is validated on input.
426 &quot;contactPhone&quot;: &quot;A String&quot;, # Required. The telephone number that device users can call, using another
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]427 # device, to get help. Zero-touch enrollment shows this number to device
428 # users before device provisioning. Accepts numerals, spaces, the plus sign,
429 # hyphens, and parentheses.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]430 &quot;dpcResourcePath&quot;: &quot;A String&quot;, # Required. The resource name of the selected DPC (device policy controller)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]431 # in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs,
432 # call
433 # `customers.dpcs.list`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]434 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the organization. Zero-touch enrollment shows this
435 # organization name to device users during device provisioning.
436 &quot;isDefault&quot;: True or False, # Required. Whether this is the default configuration that zero-touch
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]437 # enrollment applies to any new devices the organization purchases in the
438 # future. Only one customer configuration can be the default. Setting this
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]439 # value to `true`, changes the previous default configuration&#x27;s `isDefault`
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]440 # value to `false`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]441 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name in the format
442 # `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by
443 # the server.
444 &quot;configurationId&quot;: &quot;A String&quot;, # Output only. The ID of the configuration. Assigned by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]445 }</pre>
446</div>
447
448</body></html>