Skip to main content

devices

Overview

Namedevices
TypeResource
Idgoogle.cloudidentity.devices

Fields

NameDatatypeDescription
namestringOutput only. Resource name of the Device in format: devices/{device}, where device is the unique id assigned to the Device.
deviceIdstringUnique identifier for the device.
encryptionStatestringOutput only. Device encryption state.
createTimestringOutput only. When the Company-Owned device was imported. This field is empty for BYOD devices.
managementStatestringOutput only. Management state of the device
serialNumberstringSerial Number of device. Example: HT82V1A01076.
brandstringOutput only. Device brand. Example: Samsung.
securityPatchTimestringOutput only. OS security patch update time on device.
assetTagstringAsset tag of the device.
modelstringOutput only. Model name of device. Example: Pixel 3.
ownerTypestringOutput only. Whether the device is owned by the company or an individual
hostnamestringHost name of the device.
meidstringOutput only. MEID number of device if CDMA device; empty otherwise.
kernelVersionstringOutput only. Kernel version of the device.
buildNumberstringOutput only. Build number of the device.
androidSpecificAttributesobjectResource representing the Android specific attributes of a Device.
releaseVersionstringOutput only. OS release version. Example: 6.0.
lastSyncTimestringMost recent time when device synced with this service.
compromisedStatestringOutput only. Represents whether the Device is compromised.
basebandVersionstringOutput only. Baseband version of the device.
enabledDeveloperOptionsbooleanOutput only. Whether developer options is enabled on device.
wifiMacAddressesarrayWiFi MAC addresses of device.
deviceTypestringOutput only. Type of device.
enabledUsbDebuggingbooleanOutput only. Whether USB debugging is enabled on device.
imeistringOutput only. IMEI number of device if GSM device; empty otherwise.
manufacturerstringOutput only. Device manufacturer. Example: Motorola.
networkOperatorstringOutput only. Mobile or network operator of device, if available.
bootloaderVersionstringOutput only. Device bootloader version. Example: 0.6.7.
otherAccountsarrayOutput only. Domain name for Google accounts on device. Type for other accounts on device. On Android, will only be populated if |ownership_privilege| is |PROFILE_OWNER| or |DEVICE_OWNER|. Does not include the account signed in to the device policy app if that account's domain has only one account. Examples: "com.example", "xyz.com".
osVersionstringOutput only. OS version of the device. Example: Android 8.1.0.

Methods

NameAccessible byRequired ParamsDescription
getSELECTdevicesIdRetrieves the specified device.
listSELECTLists/Searches devices.
createINSERTCreates a device. Only company-owned device may be created. Note: This method is available only to customers who have one of the following SKUs: Enterprise Standard, Enterprise Plus, Enterprise for Education, and Cloud Identity Premium
deleteDELETEdevicesIdDeletes the specified device.
_listEXECLists/Searches devices.
cancel_wipeEXECdevicesIdCancels an unfinished device wipe. This operation can be used to cancel device wipe in the gap between the wipe operation returning success and the device being wiped. This operation is possible when the device is in a "pending wipe" state. The device enters the "pending wipe" state when a wipe device command is issued, but has not yet been sent to the device. The cancel wipe will fail if the wipe command has already been issued to the device.
wipeEXECdevicesIdWipes all data on the specified device.