Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 715bd7f9ca9a324a05ee05a6476af383e54930f9 / . / docs / dyn / androiddeviceprovisioning_v1.partners.customers.html
blob: bade39871d1ad30a176ef50ce50bfb6ba1fa2d0f [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">
78 <code><a href="#create">create(parent, body, x__xgafv=None)</a></code></p>
79<p class="firstline">Creates a customer for zero-touch enrollment. After the method returns</p>
80<p class="toc_element">
81 <code><a href="#list">list(partnerId, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
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">
88 <code class="details" id="create">create(parent, body, x__xgafv=None)</code>
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)
98 body: object, The request body. (required)
99 The object takes the form of:
100
101{ # Request message to create a customer.
102 "customer": { # 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's associated
104 # with a Google Account. The values for `companyId` and `name` must be empty.
105 "name": "A String", # Output only. The API resource name of the company. The resource name is one
106 # of the following formats:
107 #
108 # * `partners/[PARTNER_ID]/customers/[CUSTOMER_ID]`
109 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]`
110 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]`
111 #
112 # Assigned by the server.
113 "companyId": "A String", # Output only. The ID of the company. Assigned by the server.
114 "companyName": "A String", # Required. The name of the company. For example _XYZ Corp_. Displayed to the
115 # company's employees in the zero-touch enrollment portal.
116 "ownerEmails": [ # Input only. Email address of customer's users in the owner role. At least
117 # one `owner_email` is required. Each email address must be associated with a
118 # Google Account. Owners share the same access as admins but can also add,
119 # delete, and edit your organization's portal users.
120 "A String",
121 ],
122 "termsStatus": "A String", # Output only. Whether any user from the company has accepted the latest
123 # Terms of Service (ToS). See
124 # TermsStatus.
125 "adminEmails": [ # Input only. Optional. Email address of customer's users in the admin role.
126 # Each email address must be associated with a Google Account.
127 "A String",
128 ],
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.
141 "name": "A String", # Output only. The API resource name of the company. The resource name is one
142 # of the following formats:
143 #
144 # * `partners/[PARTNER_ID]/customers/[CUSTOMER_ID]`
145 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]`
146 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]`
147 #
148 # Assigned by the server.
149 "companyId": "A String", # Output only. The ID of the company. Assigned by the server.
150 "companyName": "A String", # Required. The name of the company. For example _XYZ Corp_. Displayed to the
151 # company's employees in the zero-touch enrollment portal.
152 "ownerEmails": [ # Input only. Email address of customer's users in the owner role. At least
153 # one `owner_email` is required. Each email address must be associated with a
154 # Google Account. Owners share the same access as admins but can also add,
155 # delete, and edit your organization's portal users.
156 "A String",
157 ],
158 "termsStatus": "A String", # Output only. Whether any user from the company has accepted the latest
159 # Terms of Service (ToS). See
160 # TermsStatus.
161 "adminEmails": [ # Input only. Optional. Email address of customer's users in the admin role.
162 # Each email address must be associated with a Google Account.
163 "A String",
164 ],
165 }</pre>
166</div>
167
168<div class="method">
169 <code class="details" id="list">list(partnerId, pageSize=None, pageToken=None, x__xgafv=None)</code>
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)
176 pageSize: integer, The maximum number of results to be returned. If not specified or 0, all
177the records are returned.
178 pageToken: string, A token identifying a page of results returned by the server.
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.
188 "nextPageToken": "A String", # A token to retrieve the next page of results. Omitted if no further results
189 # are available.
190 "totalSize": 42, # The total count of items in the list irrespective of pagination.
191 "customers": [ # List of customers related to this reseller partner.
192 { # A reseller, vendor, or customer in the zero-touch reseller and customer APIs.
193 "name": "A String", # Output only. The API resource name of the company. The resource name is one
194 # of the following formats:
195 #
196 # * `partners/[PARTNER_ID]/customers/[CUSTOMER_ID]`
197 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]`
198 # * `partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]`
199 #
200 # Assigned by the server.
201 "companyId": "A String", # Output only. The ID of the company. Assigned by the server.
202 "companyName": "A String", # Required. The name of the company. For example _XYZ Corp_. Displayed to the
203 # company's employees in the zero-touch enrollment portal.
204 "ownerEmails": [ # Input only. Email address of customer's users in the owner role. At least
205 # one `owner_email` is required. Each email address must be associated with a
206 # Google Account. Owners share the same access as admins but can also add,
207 # delete, and edit your organization's portal users.
208 "A String",
209 ],
210 "termsStatus": "A String", # Output only. Whether any user from the company has accepted the latest
211 # Terms of Service (ToS). See
212 # TermsStatus.
213 "adminEmails": [ # Input only. Optional. Email address of customer's users in the admin role.
214 # Each email address must be associated with a Google Account.
215 "A String",
216 ],
217 },
218 ],
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:
231 A request object that you can call 'execute()' on to request the next
232 page. Returns None if there are no more items in the collection.
233 </pre>
234</div>
235
236</body></html>