Resource: MobileDevice
Google Workspace Mobile Management includes Android, Google Sync, and iOS devices. For more information about common group mobile device API tasks, see the Developer's Guide.
JSON representation |
---|
{ "kind": string, "etag": string, "resourceId": string, "deviceId": string, "name": [ string ], "email": [ string ], "model": string, "os": string, "type": string, "status": string, "hardwareId": string, "firstSync": string, "lastSync": string, "userAgent": string, "serialNumber": string, "imei": string, "meid": string, "wifiMacAddress": string, "networkOperator": string, "defaultLanguage": string, "managedAccountIsOnOwnerProfile": boolean, "deviceCompromisedStatus": string, "buildNumber": string, "kernelVersion": string, "basebandVersion": string, "unknownSourcesStatus": boolean, "developerOptionsStatus": boolean, "otherAccountsInfo": [ string ], "adbStatus": boolean, "supportsWorkProfile": boolean, "manufacturer": string, "releaseVersion": string, "securityPatchLevel": string, "brand": string, "bootloaderVersion": string, "hardware": string, "encryptionStatus": string, "devicePasswordStatus": string, "privilege": string, "applications": [ { "packageName": string, "displayName": string, "versionName": string, "versionCode": integer, "permission": [ string ] } ] } |
Fields | |
---|---|
kind |
The type of the API resource. For Mobiledevices resources, the value is |
etag |
ETag of the resource. |
resourceId |
The unique ID the API service uses to identify the mobile device. |
deviceId |
The serial number for a Google Sync mobile device. For Android and iOS devices, this is a software generated unique identifier. |
name[] |
The list of the owner's user names. If your application needs the current list of device owner names, use the get method. For more information about retrieving mobile device user information, see the Developer's Guide. |
email[] |
The list of the owner's email addresses. If your application needs the current list of user emails, use the get method. For additional information, see the retrieve a user method. |
model |
The mobile device's model name, for example Nexus S. This property can be updated. For more information, see the Developer's Guide. |
os |
The mobile device's operating system, for example IOS 4.3 or Android 2.3.5. This property can be updated. For more information, see the Developer's Guide. |
type |
The type of mobile device. |
status |
The device's status. |
hardwareId |
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. |
firstSync |
The date and time the device was initially synchronized with the policy settings in the Admin console. The value is in ISO 8601 date and time format. The time is the complete date plus hours, minutes, and seconds in the form |
lastSync |
The date and time the device was last synchronized with the policy settings in the Admin console. The value is in ISO 8601 date and time format. The time is the complete date plus hours, minutes, and seconds in the form |
userAgent |
Gives information about the device such as |
serialNumber |
The device's serial number. |
imei |
The device's IMEI number. |
meid |
The device's MEID number. |
wifiMacAddress |
The device's MAC address on Wi-Fi networks. |
networkOperator |
Mobile Device mobile or network operator (if available) (Read-only) |
defaultLanguage |
The default locale used on the device. |
managedAccountIsOnOwnerProfile |
Boolean indicating if this account is on owner/primary profile or not. |
deviceCompromisedStatus |
The compromised device status. |
buildNumber |
The device's operating system build number. |
kernelVersion |
The device's kernel version. |
basebandVersion |
The device's baseband version. |
unknownSourcesStatus |
Unknown sources enabled or disabled on device (Read-only) |
developerOptionsStatus |
Developer options enabled or disabled on device (Read-only) |
otherAccountsInfo[] |
The list of accounts added on device (Read-only) |
adbStatus |
Adb (USB debugging) enabled or disabled on device (Read-only) |
supportsWorkProfile |
Work profile supported on device (Read-only) |
manufacturer |
Mobile Device manufacturer (Read-only) |
releaseVersion |
Mobile Device release version version (Read-only) |
securityPatchLevel |
Mobile Device Security patch level (Read-only) |
brand |
Mobile Device Brand (Read-only) |
bootloaderVersion |
Mobile Device Bootloader version (Read-only) |
hardware |
Mobile Device Hardware (Read-only) |
encryptionStatus |
Mobile Device Encryption Status (Read-only) |
devicePasswordStatus |
DevicePasswordStatus (Read-only) |
privilege |
DMAgentPermission (Read-only) |
applications[] |
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.
|
applications[].packageName |
The application's package name. An example is |
applications[].displayName |
The application's display name. An example is |
applications[].versionName |
The application's version name. An example is |
applications[].versionCode |
The application's version code. An example is |
applications[].permission[] |
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's Android manifest. Examples of a Calendar application's permissions are |
Methods |
|
---|---|
|
Takes an action that affects a mobile device. |
|
Removes a mobile device. |
|
Retrieves a mobile device's properties. |
|
Retrieves a paginated list of all user-owned mobile devices for an account. |