Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / b8458c0b73030155b64a3c2392b2f70e5fbc3baf / . / docs / dyn / androiddeviceprovisioning_v1.partners.customers.html
blob: b7a8873f31c0d40d23b1f85f12707d595511da1f [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.partners.html">partners</a> . <a href="androiddeviceprovisioning_v1.partners.customers.html">customers</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 customer for zero-touch enrollment. After the method returns</p>
80<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]81 <code><a href="#list">list(partnerId, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]82<p class="firstline">Lists the customers that are enrolled to the reseller identified by the</p>
83<p class="toc_element">
84 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
85<p class="firstline">Retrieves the next page of results.</p>
86<h3>Method Details</h3>
87<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]88 <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]89 <pre>Creates a customer for zero-touch enrollment. After the method returns
90successfully, admin and owner roles can manage devices and EMM configs
91by calling API methods or using their zero-touch enrollment portal.
92The customer receives an email that welcomes them to zero-touch enrollment
93and explains how to sign into the portal.
94
95Args:
96 parent: string, Required. The parent resource ID in the format `partners/[PARTNER_ID]` that
97identifies the reseller. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]98 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]99 The object takes the form of:
100
101{ # Request message to create a customer.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]102 &quot;customer&quot;: { # A reseller, vendor, or customer in the zero-touch reseller and customer APIs. # Required. The company data to populate the new customer. Must contain a
103 # value for `companyName` and at least one `owner_email` that&#x27;s associated
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]104 # with a Google Account. The values for `companyId` and `name` must be empty.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]105 &quot;companyId&quot;: &quot;A String&quot;, # Output only. The ID of the company. Assigned by the server.
106 &quot;ownerEmails&quot;: [ # Input only. Email address of customer&#x27;s users in the owner role. At least
107 # one `owner_email` is required. Each email address must be associated with a
108 # Google Account. Owners share the same access as admins but can also add,
109 # delete, and edit your organization&#x27;s portal users.
110 &quot;A String&quot;,
111 ],
112 &quot;adminEmails&quot;: [ # Optional. Input only. Email address of customer&#x27;s users in the admin role.
113 # Each email address must be associated with a Google Account.
114 &quot;A String&quot;,
115 ],
116 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the company. For example _XYZ Corp_. Displayed to the
117 # company&#x27;s employees in the zero-touch enrollment portal.
118 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name of the company. The resource name is one
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]119 # of the following formats:
120 #
121 # * `partners/[PARTNER_ID]/customers/[CUSTOMER_ID]`
122 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]`
123 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]`
124 #
125 # Assigned by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]126 &quot;termsStatus&quot;: &quot;A String&quot;, # Output only. Whether any user from the company has accepted the latest
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]127 # Terms of Service (ToS). See
128 # TermsStatus.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]129 },
130 }
131
132 x__xgafv: string, V1 error format.
133 Allowed values
134 1 - v1 error format
135 2 - v2 error format
136
137Returns:
138 An object of the form:
139
140 { # A reseller, vendor, or customer in the zero-touch reseller and customer APIs.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]141 &quot;companyId&quot;: &quot;A String&quot;, # Output only. The ID of the company. Assigned by the server.
142 &quot;ownerEmails&quot;: [ # Input only. Email address of customer&#x27;s users in the owner role. At least
143 # one `owner_email` is required. Each email address must be associated with a
144 # Google Account. Owners share the same access as admins but can also add,
145 # delete, and edit your organization&#x27;s portal users.
146 &quot;A String&quot;,
147 ],
148 &quot;adminEmails&quot;: [ # Optional. Input only. Email address of customer&#x27;s users in the admin role.
149 # Each email address must be associated with a Google Account.
150 &quot;A String&quot;,
151 ],
152 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the company. For example _XYZ Corp_. Displayed to the
153 # company&#x27;s employees in the zero-touch enrollment portal.
154 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name of the company. The resource name is one
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]155 # of the following formats:
156 #
157 # * `partners/[PARTNER_ID]/customers/[CUSTOMER_ID]`
158 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]`
159 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]`
160 #
161 # Assigned by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]162 &quot;termsStatus&quot;: &quot;A String&quot;, # Output only. Whether any user from the company has accepted the latest
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]163 # Terms of Service (ToS). See
164 # TermsStatus.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]165 }</pre>
166</div>
167
168<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]169 <code class="details" id="list">list(partnerId, pageToken=None, pageSize=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]170 <pre>Lists the customers that are enrolled to the reseller identified by the
171`partnerId` argument. This list includes customers that the reseller
172created and customers that enrolled themselves using the portal.
173
174Args:
175 partnerId: string, Required. The ID of the reseller partner. (required)
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]176 pageToken: string, A token identifying a page of results returned by the server.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]177 pageSize: integer, The maximum number of results to be returned. If not specified or 0, all
178the records are returned.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]179 x__xgafv: string, V1 error format.
180 Allowed values
181 1 - v1 error format
182 2 - v2 error format
183
184Returns:
185 An object of the form:
186
187 { # Response message of all customers related to this partner.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]188 &quot;totalSize&quot;: 42, # The total count of items in the list irrespective of pagination.
189 &quot;customers&quot;: [ # List of customers related to this reseller partner.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]190 { # A reseller, vendor, or customer in the zero-touch reseller and customer APIs.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]191 &quot;companyId&quot;: &quot;A String&quot;, # Output only. The ID of the company. Assigned by the server.
192 &quot;ownerEmails&quot;: [ # Input only. Email address of customer&#x27;s users in the owner role. At least
193 # one `owner_email` is required. Each email address must be associated with a
194 # Google Account. Owners share the same access as admins but can also add,
195 # delete, and edit your organization&#x27;s portal users.
196 &quot;A String&quot;,
197 ],
198 &quot;adminEmails&quot;: [ # Optional. Input only. Email address of customer&#x27;s users in the admin role.
199 # Each email address must be associated with a Google Account.
200 &quot;A String&quot;,
201 ],
202 &quot;companyName&quot;: &quot;A String&quot;, # Required. The name of the company. For example _XYZ Corp_. Displayed to the
203 # company&#x27;s employees in the zero-touch enrollment portal.
204 &quot;name&quot;: &quot;A String&quot;, # Output only. The API resource name of the company. The resource name is one
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]205 # of the following formats:
206 #
207 # * `partners/[PARTNER_ID]/customers/[CUSTOMER_ID]`
208 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]`
209 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]`
210 #
211 # Assigned by the server.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]212 &quot;termsStatus&quot;: &quot;A String&quot;, # Output only. Whether any user from the company has accepted the latest
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]213 # Terms of Service (ToS). See
214 # TermsStatus.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]215 },
216 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]217 &quot;nextPageToken&quot;: &quot;A String&quot;, # A token to retrieve the next page of results. Omitted if no further results
218 # are available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]219 }</pre>
220</div>
221
222<div class="method">
223 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
224 <pre>Retrieves the next page of results.
225
226Args:
227 previous_request: The request for the previous page. (required)
228 previous_response: The response from the request for the previous page. (required)
229
230Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]231 A request object that you can call &#x27;execute()&#x27; on to request the next
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]232 page. Returns None if there are no more items in the collection.
233 </pre>
234</div>
235
236</body></html>