Skip to main content

devices

Overview

Namedevices
TypeResource
Idgoogledevelopers.androidenterprise.devices

Fields

NameDatatypeDescription
managementTypestringIdentifies the extent to which the device is controlled by a managed Google Play EMM in various deployment configurations. Possible values include: - "managedDevice", a device that has the EMM's device policy controller (DPC) as the device owner. - "managedProfile", a device that has a profile managed by the DPC (DPC is profile owner) in addition to a separate, personal profile that is unavailable to the DPC. - "containerApp", no longer used (deprecated). - "unmanagedProfile", a device that has been allowed (by the domain's admin, using the Admin Console to enable the privilege) to use managed Google Play, but the profile is itself not owned by a DPC.
policyobjectThe device policy for a given managed device.
reportobjectDevice report updated with the latest app states for managed apps on the device.
androidIdstringThe Google Play Services Android ID for the device encoded as a lowercase hex string. For example, "123456789abcdef0".

Methods

NameAccessible byRequired ParamsDescription
getSELECTdeviceId, enterpriseId, userIdRetrieves the details of a device.
listSELECTenterpriseId, userIdRetrieves the IDs of all of a user's devices.
forceReportUploadEXECdeviceId, enterpriseId, userIdUploads a report containing any changes in app states on the device since the last report was generated. You can call this method up to 3 times every 24 hours for a given device. If you exceed the quota, then the Google Play EMM API returns HTTP 429 Too Many Requests.
setStateEXECdeviceId, enterpriseId, userIdSets whether a device's access to Google services is enabled or disabled. The device state takes effect only if enforcing EMM policies on Android devices is enabled in the Google Admin Console. Otherwise, the device state is ignored and all devices are allowed access to Google services. This is only supported for Google-managed users.
updateEXECdeviceId, enterpriseId, userIdUpdates the device policy. To ensure the policy is properly enforced, you need to prevent unmanaged accounts from accessing Google Play by setting the allowed_accounts in the managed configuration for the Google Play package. See restrict accounts in Google Play. When provisioning a new device, you should set the device policy using this method before adding the managed Google Play Account to the device, otherwise the policy will not be applied for a short period of time after adding the account to the device.