Debian Codegraph @

docs/dyn/admin_directory_v1.mobiledevices.html

raw
1 <html><body>
2 <style>
3
4 body, 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
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, 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="admin_directory_v1.html">Admin SDK API</a> . <a href="admin_directory_v1.mobiledevices.html">mobiledevices</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#action">action(customerId, resourceId, body=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Takes an action that affects a mobile device. For example, remotely wiping a device.</p>
80 <p class="toc_element">
81 <code><a href="#close">close()</a></code></p>
82 <p class="firstline">Close httplib2 connections.</p>
83 <p class="toc_element">
84 <code><a href="#delete">delete(customerId, resourceId, x__xgafv=None)</a></code></p>
85 <p class="firstline">Removes a mobile device.</p>
86 <p class="toc_element">
87 <code><a href="#get">get(customerId, resourceId, projection=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Retrieves a mobile device's properties.</p>
89 <p class="toc_element">
90 <code><a href="#list">list(customerId, maxResults=None, orderBy=None, pageToken=None, projection=None, query=None, sortOrder=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Retrieves a paginated list of all user-owned mobile devices for an account. To retrieve a list that includes company-owned devices, use the Cloud Identity [Devices API](https://cloud.google.com/identity/docs/concepts/overview-devices) instead. This method times out after 60 minutes. For more information, see [Troubleshoot error codes](https://developers.google.com/workspace/admin/directory/v1/guides/troubleshoot-error-codes).</p>
92 <p class="toc_element">
93 <code><a href="#list_next">list_next()</a></code></p>
94 <p class="firstline">Retrieves the next page of results.</p>
95 <h3>Method Details</h3>
96 <div class="method">
97 <code class="details" id="action">action(customerId, resourceId, body=None, x__xgafv=None)</code>
98 <pre>Takes an action that affects a mobile device. For example, remotely wiping a device.
99
100 Args:
101 customerId: string, The unique ID for the customer&#x27;s Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account&#x27;s `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). (required)
102 resourceId: string, The unique ID the API service uses to identify the mobile device. (required)
103 body: object, The request body.
104 The object takes the form of:
105
106 {
107 &quot;action&quot;: &quot;A String&quot;, # The action to be performed on the device.
108 }
109
110 x__xgafv: string, V1 error format.
111 Allowed values
112 1 - v1 error format
113 2 - v2 error format
114 </pre>
115 </div>
116
117 <div class="method">
118 <code class="details" id="close">close()</code>
119 <pre>Close httplib2 connections.</pre>
120 </div>
121
122 <div class="method">
123 <code class="details" id="delete">delete(customerId, resourceId, x__xgafv=None)</code>
124 <pre>Removes a mobile device.
125
126 Args:
127 customerId: string, The unique ID for the customer&#x27;s Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account&#x27;s `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). (required)
128 resourceId: string, The unique ID the API service uses to identify the mobile device. (required)
129 x__xgafv: string, V1 error format.
130 Allowed values
131 1 - v1 error format
132 2 - v2 error format
133 </pre>
134 </div>
135
136 <div class="method">
137 <code class="details" id="get">get(customerId, resourceId, projection=None, x__xgafv=None)</code>
138 <pre>Retrieves a mobile device&#x27;s properties.
139
140 Args:
141 customerId: string, The unique ID for the customer&#x27;s Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account&#x27;s `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). (required)
142 resourceId: string, The unique ID the API service uses to identify the mobile device. (required)
143 projection: string, Restrict information returned to a set of selected fields.
144 Allowed values
145 BASIC - Includes only the basic metadata fields (e.g., deviceId, model, status, type, and status)
146 FULL - Includes all metadata fields
147 x__xgafv: string, V1 error format.
148 Allowed values
149 1 - v1 error format
150 2 - v2 error format
151
152 Returns:
153 An object of the form:
154
155 { # Google Workspace Mobile Management includes Android, [Google Sync](https://support.google.com/a/answer/135937), and iOS devices. For more information about common group mobile device API tasks, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-mobile-devices.html).
156 &quot;adbStatus&quot;: True or False, # Adb (USB debugging) enabled or disabled on device (Read-only)
157 &quot;applications&quot;: [ # The list of applications installed on an Android mobile device. It is not applicable to Google Sync and iOS devices. The list includes any Android applications that access Google Workspace data. When updating an applications list, it is important to note that updates replace the existing list. If the Android device has two existing applications and the API updates the list with five applications, the is now the updated list of five applications.
158 {
159 &quot;displayName&quot;: &quot;A String&quot;, # The application&#x27;s display name. An example is `Browser`.
160 &quot;packageName&quot;: &quot;A String&quot;, # The application&#x27;s package name. An example is `com.android.browser`.
161 &quot;permission&quot;: [ # The list of permissions of this application. These can be either a standard Android permission or one defined by the application, and are found in an application&#x27;s [Android manifest](https://developer.android.com/guide/topics/manifest/uses-permission-element.html). Examples of a Calendar application&#x27;s permissions are `READ_CALENDAR`, or `MANAGE_ACCOUNTS`.
162 &quot;A String&quot;,
163 ],
164 &quot;versionCode&quot;: 42, # The application&#x27;s version code. An example is `13`.
165 &quot;versionName&quot;: &quot;A String&quot;, # The application&#x27;s version name. An example is `3.2-140714`.
166 },
167 ],
168 &quot;basebandVersion&quot;: &quot;A String&quot;, # The device&#x27;s baseband version.
169 &quot;bootloaderVersion&quot;: &quot;A String&quot;, # Mobile Device Bootloader version (Read-only)
170 &quot;brand&quot;: &quot;A String&quot;, # Mobile Device Brand (Read-only)
171 &quot;buildNumber&quot;: &quot;A String&quot;, # The device&#x27;s operating system build number.
172 &quot;defaultLanguage&quot;: &quot;A String&quot;, # The default locale used on the device.
173 &quot;developerOptionsStatus&quot;: True or False, # Developer options enabled or disabled on device (Read-only)
174 &quot;deviceCompromisedStatus&quot;: &quot;A String&quot;, # The compromised device status.
175 &quot;deviceId&quot;: &quot;A String&quot;, # The serial number for a Google Sync mobile device. For Android and iOS devices, this is a software generated unique identifier.
176 &quot;devicePasswordStatus&quot;: &quot;A String&quot;, # DevicePasswordStatus (Read-only)
177 &quot;email&quot;: [ # The list of the owner&#x27;s email addresses. If your application needs the current list of user emails, use the [get](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/get.html) method. For additional information, see the [retrieve a user](https://developers.google.com/workspace/admin/directory/v1/guides/manage-users#get_user) method.
178 &quot;A String&quot;,
179 ],
180 &quot;encryptionStatus&quot;: &quot;A String&quot;, # Mobile Device Encryption Status (Read-only)
181 &quot;etag&quot;: &quot;A String&quot;, # ETag of the resource.
182 &quot;firstSync&quot;: &quot;A String&quot;, # Date and time the device was first synchronized with the policy settings in the G Suite administrator control panel (Read-only)
183 &quot;hardware&quot;: &quot;A String&quot;, # Mobile Device Hardware (Read-only)
184 &quot;hardwareId&quot;: &quot;A String&quot;, # The IMEI/MEID unique identifier for Android hardware. It is not applicable to Google Sync devices. When adding an Android mobile device, this is an optional property. When updating one of these devices, this is a read-only property.
185 &quot;imei&quot;: &quot;A String&quot;, # The device&#x27;s IMEI number.
186 &quot;kernelVersion&quot;: &quot;A String&quot;, # The device&#x27;s kernel version.
187 &quot;kind&quot;: &quot;admin#directory#mobiledevice&quot;, # The type of the API resource. For Mobiledevices resources, the value is `admin#directory#mobiledevice`.
188 &quot;lastSync&quot;: &quot;A String&quot;, # Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only)
189 &quot;managedAccountIsOnOwnerProfile&quot;: True or False, # Boolean indicating if this account is on owner/primary profile or not.
190 &quot;manufacturer&quot;: &quot;A String&quot;, # Mobile Device manufacturer (Read-only)
191 &quot;meid&quot;: &quot;A String&quot;, # The device&#x27;s MEID number.
192 &quot;model&quot;: &quot;A String&quot;, # The mobile device&#x27;s model name, for example Nexus S. This property can be [updated](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/update.html). For more information, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-mobile=devices#update_mobile_device).
193 &quot;name&quot;: [ # The list of the owner&#x27;s user names. If your application needs the current list of device owner names, use the [get](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/get.html) method. For more information about retrieving mobile device user information, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-users#get_user).
194 &quot;A String&quot;,
195 ],
196 &quot;networkOperator&quot;: &quot;A String&quot;, # Mobile Device mobile or network operator (if available) (Read-only)
197 &quot;os&quot;: &quot;A String&quot;, # The mobile device&#x27;s operating system, for example IOS 4.3 or Android 2.3.5. This property can be [updated](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/update.html). For more information, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-mobile-devices#update_mobile_device).
198 &quot;otherAccountsInfo&quot;: [ # The list of accounts added on device (Read-only)
199 &quot;A String&quot;,
200 ],
201 &quot;privilege&quot;: &quot;A String&quot;, # DMAgentPermission (Read-only)
202 &quot;releaseVersion&quot;: &quot;A String&quot;, # Mobile Device release version version (Read-only)
203 &quot;resourceId&quot;: &quot;A String&quot;, # The unique ID the API service uses to identify the mobile device.
204 &quot;securityPatchLevel&quot;: &quot;A String&quot;, # Mobile Device Security patch level (Read-only)
205 &quot;serialNumber&quot;: &quot;A String&quot;, # The device&#x27;s serial number.
206 &quot;status&quot;: &quot;A String&quot;, # The device&#x27;s status.
207 &quot;supportsWorkProfile&quot;: True or False, # Work profile supported on device (Read-only)
208 &quot;type&quot;: &quot;A String&quot;, # The type of mobile device.
209 &quot;unknownSourcesStatus&quot;: True or False, # Unknown sources enabled or disabled on device (Read-only)
210 &quot;userAgent&quot;: &quot;A String&quot;, # Gives information about the device such as `os` version. This property can be [updated](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/update.html). For more information, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-mobile-devices#update_mobile_device).
211 &quot;wifiMacAddress&quot;: &quot;A String&quot;, # The device&#x27;s MAC address on Wi-Fi networks.
212 }</pre>
213 </div>
214
215 <div class="method">
216 <code class="details" id="list">list(customerId, maxResults=None, orderBy=None, pageToken=None, projection=None, query=None, sortOrder=None, x__xgafv=None)</code>
217 <pre>Retrieves a paginated list of all user-owned mobile devices for an account. To retrieve a list that includes company-owned devices, use the Cloud Identity [Devices API](https://cloud.google.com/identity/docs/concepts/overview-devices) instead. This method times out after 60 minutes. For more information, see [Troubleshoot error codes](https://developers.google.com/workspace/admin/directory/v1/guides/troubleshoot-error-codes).
218
219 Args:
220 customerId: string, The unique ID for the customer&#x27;s Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account&#x27;s `customerId`. The `customerId` is also returned as part of the [Users resource](https://developers.google.com/workspace/admin/directory/v1/reference/users). (required)
221 maxResults: integer, Maximum number of results to return. Max allowed value is 100.
222 orderBy: string, Device property to use for sorting results.
223 Allowed values
224 deviceId - The serial number for a Google Sync mobile device. For Android devices, this is a software generated unique identifier.
225 email - The device owner&#x27;s email address.
226 lastSync - Last policy settings sync date time of the device.
227 model - The mobile device&#x27;s model.
228 name - The device owner&#x27;s user name.
229 os - The device&#x27;s operating system.
230 status - The device status.
231 type - Type of the device.
232 pageToken: string, Token to specify next page in the list
233 projection: string, Restrict information returned to a set of selected fields.
234 Allowed values
235 BASIC - Includes only the basic metadata fields (e.g., deviceId, model, status, type, and status)
236 FULL - Includes all metadata fields
237 query: string, Search string in the format given at https://developers.google.com/workspace/admin/directory/v1/search-operators
238 sortOrder: string, Whether to return results in ascending or descending order. Must be used with the `orderBy` parameter.
239 Allowed values
240 ASCENDING - Ascending order.
241 DESCENDING - Descending order.
242 x__xgafv: string, V1 error format.
243 Allowed values
244 1 - v1 error format
245 2 - v2 error format
246
247 Returns:
248 An object of the form:
249
250 {
251 &quot;etag&quot;: &quot;A String&quot;, # ETag of the resource.
252 &quot;kind&quot;: &quot;admin#directory#mobiledevices&quot;, # Kind of resource this is.
253 &quot;mobiledevices&quot;: [ # A list of Mobile Device objects.
254 { # Google Workspace Mobile Management includes Android, [Google Sync](https://support.google.com/a/answer/135937), and iOS devices. For more information about common group mobile device API tasks, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-mobile-devices.html).
255 &quot;adbStatus&quot;: True or False, # Adb (USB debugging) enabled or disabled on device (Read-only)
256 &quot;applications&quot;: [ # The list of applications installed on an Android mobile device. It is not applicable to Google Sync and iOS devices. The list includes any Android applications that access Google Workspace data. When updating an applications list, it is important to note that updates replace the existing list. If the Android device has two existing applications and the API updates the list with five applications, the is now the updated list of five applications.
257 {
258 &quot;displayName&quot;: &quot;A String&quot;, # The application&#x27;s display name. An example is `Browser`.
259 &quot;packageName&quot;: &quot;A String&quot;, # The application&#x27;s package name. An example is `com.android.browser`.
260 &quot;permission&quot;: [ # The list of permissions of this application. These can be either a standard Android permission or one defined by the application, and are found in an application&#x27;s [Android manifest](https://developer.android.com/guide/topics/manifest/uses-permission-element.html). Examples of a Calendar application&#x27;s permissions are `READ_CALENDAR`, or `MANAGE_ACCOUNTS`.
261 &quot;A String&quot;,
262 ],
263 &quot;versionCode&quot;: 42, # The application&#x27;s version code. An example is `13`.
264 &quot;versionName&quot;: &quot;A String&quot;, # The application&#x27;s version name. An example is `3.2-140714`.
265 },
266 ],
267 &quot;basebandVersion&quot;: &quot;A String&quot;, # The device&#x27;s baseband version.
268 &quot;bootloaderVersion&quot;: &quot;A String&quot;, # Mobile Device Bootloader version (Read-only)
269 &quot;brand&quot;: &quot;A String&quot;, # Mobile Device Brand (Read-only)
270 &quot;buildNumber&quot;: &quot;A String&quot;, # The device&#x27;s operating system build number.
271 &quot;defaultLanguage&quot;: &quot;A String&quot;, # The default locale used on the device.
272 &quot;developerOptionsStatus&quot;: True or False, # Developer options enabled or disabled on device (Read-only)
273 &quot;deviceCompromisedStatus&quot;: &quot;A String&quot;, # The compromised device status.
274 &quot;deviceId&quot;: &quot;A String&quot;, # The serial number for a Google Sync mobile device. For Android and iOS devices, this is a software generated unique identifier.
275 &quot;devicePasswordStatus&quot;: &quot;A String&quot;, # DevicePasswordStatus (Read-only)
276 &quot;email&quot;: [ # The list of the owner&#x27;s email addresses. If your application needs the current list of user emails, use the [get](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/get.html) method. For additional information, see the [retrieve a user](https://developers.google.com/workspace/admin/directory/v1/guides/manage-users#get_user) method.
277 &quot;A String&quot;,
278 ],
279 &quot;encryptionStatus&quot;: &quot;A String&quot;, # Mobile Device Encryption Status (Read-only)
280 &quot;etag&quot;: &quot;A String&quot;, # ETag of the resource.
281 &quot;firstSync&quot;: &quot;A String&quot;, # Date and time the device was first synchronized with the policy settings in the G Suite administrator control panel (Read-only)
282 &quot;hardware&quot;: &quot;A String&quot;, # Mobile Device Hardware (Read-only)
283 &quot;hardwareId&quot;: &quot;A String&quot;, # The IMEI/MEID unique identifier for Android hardware. It is not applicable to Google Sync devices. When adding an Android mobile device, this is an optional property. When updating one of these devices, this is a read-only property.
284 &quot;imei&quot;: &quot;A String&quot;, # The device&#x27;s IMEI number.
285 &quot;kernelVersion&quot;: &quot;A String&quot;, # The device&#x27;s kernel version.
286 &quot;kind&quot;: &quot;admin#directory#mobiledevice&quot;, # The type of the API resource. For Mobiledevices resources, the value is `admin#directory#mobiledevice`.
287 &quot;lastSync&quot;: &quot;A String&quot;, # Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only)
288 &quot;managedAccountIsOnOwnerProfile&quot;: True or False, # Boolean indicating if this account is on owner/primary profile or not.
289 &quot;manufacturer&quot;: &quot;A String&quot;, # Mobile Device manufacturer (Read-only)
290 &quot;meid&quot;: &quot;A String&quot;, # The device&#x27;s MEID number.
291 &quot;model&quot;: &quot;A String&quot;, # The mobile device&#x27;s model name, for example Nexus S. This property can be [updated](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/update.html). For more information, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-mobile=devices#update_mobile_device).
292 &quot;name&quot;: [ # The list of the owner&#x27;s user names. If your application needs the current list of device owner names, use the [get](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/get.html) method. For more information about retrieving mobile device user information, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-users#get_user).
293 &quot;A String&quot;,
294 ],
295 &quot;networkOperator&quot;: &quot;A String&quot;, # Mobile Device mobile or network operator (if available) (Read-only)
296 &quot;os&quot;: &quot;A String&quot;, # The mobile device&#x27;s operating system, for example IOS 4.3 or Android 2.3.5. This property can be [updated](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/update.html). For more information, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-mobile-devices#update_mobile_device).
297 &quot;otherAccountsInfo&quot;: [ # The list of accounts added on device (Read-only)
298 &quot;A String&quot;,
299 ],
300 &quot;privilege&quot;: &quot;A String&quot;, # DMAgentPermission (Read-only)
301 &quot;releaseVersion&quot;: &quot;A String&quot;, # Mobile Device release version version (Read-only)
302 &quot;resourceId&quot;: &quot;A String&quot;, # The unique ID the API service uses to identify the mobile device.
303 &quot;securityPatchLevel&quot;: &quot;A String&quot;, # Mobile Device Security patch level (Read-only)
304 &quot;serialNumber&quot;: &quot;A String&quot;, # The device&#x27;s serial number.
305 &quot;status&quot;: &quot;A String&quot;, # The device&#x27;s status.
306 &quot;supportsWorkProfile&quot;: True or False, # Work profile supported on device (Read-only)
307 &quot;type&quot;: &quot;A String&quot;, # The type of mobile device.
308 &quot;unknownSourcesStatus&quot;: True or False, # Unknown sources enabled or disabled on device (Read-only)
309 &quot;userAgent&quot;: &quot;A String&quot;, # Gives information about the device such as `os` version. This property can be [updated](https://developers.google.com/workspace/admin/directory/v1/reference/mobiledevices/update.html). For more information, see the [Developer&#x27;s Guide](https://developers.google.com/workspace/admin/directory/v1/guides/manage-mobile-devices#update_mobile_device).
310 &quot;wifiMacAddress&quot;: &quot;A String&quot;, # The device&#x27;s MAC address on Wi-Fi networks.
311 },
312 ],
313 &quot;nextPageToken&quot;: &quot;A String&quot;, # Token used to access next page of this result.
314 }</pre>
315 </div>
316
317 <div class="method">
318 <code class="details" id="list_next">list_next()</code>
319 <pre>Retrieves the next page of results.
320
321 Args:
322 previous_request: The request for the previous page. (required)
323 previous_response: The response from the request for the previous page. (required)
324
325 Returns:
326 A request object that you can call &#x27;execute()&#x27; on to request the next
327 page. Returns None if there are no more items in the collection.
328 </pre>
329 </div>
330
331 </body></html>