Devices: update

  • This operation updates a device's policy, requiring authorization with the https://www.googleapis.com/auth/androidenterprise scope.

  • To enforce the policy effectively, it's crucial to restrict unmanaged accounts from accessing Google Play by configuring allowed_accounts in the managed configuration for the Google Play package.

  • You can specify which fields to update using the updateMask query parameter, otherwise all modifiable fields will be changed.

  • The request utilizes a PUT method and targets a specific URL structure including enterprise ID, user ID, and device ID.

  • A successful operation returns a Devices resource, reflecting the updated device policy information.

Updates 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.

Request

HTTP request

PUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId

Parameters

Parameter name Value Description
Path parameters
deviceId string The ID of the device.
enterpriseId string The ID of the enterprise.
userId string The ID of the user.
Optional query parameters
updateMask string Mask that identifies which fields to update. If not set, all modifiable fields will be modified.

When set in a query parameter, this field should be specified as updateMask=<field1>,<field2>,...

Authorization

This request requires authorization with the following scope:

Scope
https://www.googleapis.com/auth/androidenterprise

For more information, see the authentication and authorization page.

Request body

In the request body, supply a Devices resource.

Response

If successful, this method returns a Devices resource in the response body.