Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1339117150.4 KB
devices

Creates 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

post/v1/devices

Query parameters

customerstring

Optional. Resource name of the customer. If you're using this API for your own organization, use customers/my_customer If you're using this API to manage another organization, use customers/{customer}, where customer is the customer to whom the device belongs.

Request body

deviceType'DEVICE_TYPE_UNSPECIFIED' | 'ANDROID' | 'IOS' | 'GOOGLE_SYNC' | 'WINDOWS' | 'MAC_OS' | 'LINUX' | 'CHROME_OS'

Output only. Type of device.

manufacturerstring

Output only. Device manufacturer. Example: Motorola.

lastSyncTimestring google-datetime

Most recent time when device synced with this service.

hostnamestring

Host name of the device.

serialNumberstring

Serial Number of device. Example: HT82V1A01076.

bootloaderVersionstring

Output only. Device bootloader version. Example: 0.6.7.

buildNumberstring

Output only. Build number of the device.

releaseVersionstring

Output only. OS release version. Example: 6.0.

namestring

Output only. Resource name of the Device in format: devices/{device}, where device is the unique id assigned to the Device. Important: Device API scopes require that you use domain-wide delegation to access the API. For more information, see Set up the Devices API.

kernelVersionstring

Output only. Kernel version of the device.

osVersionstring

Output only. OS version of the device. Example: Android 8.1.0.

wifiMacAddressesstring[]

WiFi MAC addresses of device.

ownerType'DEVICE_OWNERSHIP_UNSPECIFIED' | 'COMPANY' | 'BYOD'

Output only. Whether the device is owned by the company or an individual

encryptionState'ENCRYPTION_STATE_UNSPECIFIED' | 'UNSUPPORTED_BY_DEVICE' | 'ENCRYPTED' | 'NOT_ENCRYPTED'

Output only. Device encryption state.

modelstring

Output only. Model name of device. Example: Pixel 3.

createTimestring google-datetime

Output only. When the Company-Owned device was imported. This field is empty for BYOD devices.

unifiedDeviceIdstring

Output only. Unified device id of the device.

brandstring

Output only. Device brand. Example: Samsung.

securityPatchTimestring google-datetime

Output only. OS security patch update time on device.

assetTagstring

Asset tag of the device.

enabledDeveloperOptionsboolean

Output only. Whether developer options is enabled on device.

basebandVersionstring

Output only. Baseband version of the device.

networkOperatorstring

Output only. Mobile or network operator of device, if available.

enabledUsbDebuggingboolean

Output only. Whether USB debugging is enabled on device.

imeistring

Output only. IMEI number of device if GSM device; empty otherwise.

meidstring

Output only. MEID number of device if CDMA device; empty otherwise.

deviceIdstring

Unique identifier for the device.

otherAccountsstring[]

Output 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".

managementState'MANAGEMENT_STATE_UNSPECIFIED' | 'APPROVED' | 'BLOCKED' | 'PENDING' | 'UNPROVISIONED' | 'WIPING' | 'WIPED'

Output only. Management state of the device

compromisedState'COMPROMISED_STATE_UNSPECIFIED' | 'COMPROMISED' | 'UNCOMPROMISED'

Output only. Represents whether the Device is compromised.

Response

Successful response