Skip to main content

devices

Overview

Namedevices
TypeResource
Idgoogledevelopers.androidmanagement.devices

Fields

NameDatatypeDescription
namestringThe name of the device in the form enterprises/{enterpriseId}/devices/{deviceId}.
userobjectA user belonging to an enterprise.
softwareInfoobjectInformation about device software.
deviceSettingsobjectInformation about security related device settings on device.
lastPolicyComplianceReportTimestringDeprecated.
disabledReasonobjectProvides a user-facing message with locale info. The maximum message length is 4096 characters.
commonCriteriaModeInfoobjectInformation about Common Criteria Mode—security standards defined in the Common Criteria for Information Technology Security Evaluation (https://www.commoncriteriaportal.org/) (CC).This information is only available if statusReportingSettings.commonCriteriaModeEnabled is true in the device's policy.
enrollmentTimestringThe time of device enrollment.
applicationReportsarrayReports for apps installed on the device. This information is only available when application_reports_enabled is true in the device's policy.
policyCompliantbooleanWhether the device is compliant with its policy.
nonComplianceDetailsarrayDetails about policy settings that the device is not compliant with.
managementModestringThe type of management mode Android Device Policy takes on the device. This influences which policy settings are supported.
ownershipstringOwnership of the managed device.
lastStatusReportTimestringThe last time the device sent a status report.
memoryEventsarrayEvents related to memory and storage measurements in chronological order. This information is only available if memoryInfoEnabled is true in the device's policy.
systemPropertiesobjectMap of selected system properties name and value related to the device. This information is only available if systemPropertiesEnabled is true in the device's policy.
appliedStatestringThe state currently applied to the device.
appliedPasswordPoliciesarrayThe password requirements currently applied to the device. The applied requirements may be slightly different from those specified in passwordPolicies in some cases. fieldPath is set based on passwordPolicies.
powerManagementEventsarrayPower management events on the device in chronological order. This information is only available if powerManagementEventsEnabled is true in the device's policy.
hardwareStatusSamplesarrayHardware status samples in chronological order. This information is only available if hardwareStatusEnabled is true in the device's policy.
statestringThe state to be applied to the device. This field can be modified by a patch request. Note that when calling enterprises.devices.patch, ACTIVE and DISABLED are the only allowable values. To enter the device into a DELETED state, call enterprises.devices.delete.
userNamestringThe resource name of the user that owns this device in the form enterprises/{enterpriseId}/users/{userId}.
securityPostureobjectThe security posture of the device, as determined by the current device state and the policies applied.
appliedPolicyNamestringThe name of the policy currently applied to the device.
hardwareInfoobjectInformation about device hardware. The fields related to temperature thresholds are only available if hardwareStatusEnabled is true in the device's policy.
previousDeviceNamesarrayIf the same physical device has been enrolled multiple times, this field contains its previous device names. The serial number is used as the unique identifier to determine if the same physical device has enrolled previously. The names are in chronological order.
appliedPolicyVersionstringThe version of the policy currently applied to the device.
networkInfoobjectDevice network info.
enrollmentTokenNamestringIf the device was enrolled with an enrollment token, this field contains the name of the token.
displaysarrayDetailed information about displays on the device. This information is only available if displayInfoEnabled is true in the device's policy.
enrollmentTokenDatastringIf the device was enrolled with an enrollment token with additional data provided, this field contains that data.
lastPolicySyncTimestringThe last time the device fetched its policy.
memoryInfoobjectInformation about device memory and storage.
apiLevelintegerThe API level of the Android platform version running on the device.
policyNamestringThe name of the policy applied to the device, in the form enterprises/{enterpriseId}/policies/{policyId}. If not specified, the policy_name for the device's user is applied. This field can be modified by a patch request. You can specify only the policyId when calling enterprises.devices.patch, as long as the policyId doesn’t contain any slashes. The rest of the policy name is inferred.

Methods

NameAccessible byRequired ParamsDescription
enterprises_devices_getSELECTdevicesId, enterprisesIdGets a device. Deleted devices will respond with a 404 error.
enterprises_devices_listSELECTenterprisesIdLists devices for a given enterprise. Deleted devices are not returned in the response.
enterprises_devices_deleteDELETEdevicesId, enterprisesIdDeletes a device. This operation wipes the device. Deleted devices do not show up in enterprises.devices.list calls and a 404 is returned from enterprises.devices.get.
enterprises_devices_issueCommandEXECdevicesId, enterprisesIdIssues a command to a device. The Operation resource returned contains a Command in its metadata field. Use the get operation method to get the status of the command.
enterprises_devices_patchEXECdevicesId, enterprisesIdUpdates a device.