Important: We are no longer accepting new registrations for the Play EMM API.
Learn more.
Devices: update
Stay organized with collections
Save and categorize content based on your preferences.
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.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-31 UTC.
[null,null,["Last updated 2024-10-31 UTC."],[[["\u003cp\u003eThis operation updates a device's policy, requiring authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eTo enforce the policy effectively, it's crucial to restrict unmanaged accounts from accessing Google Play by configuring \u003ccode\u003eallowed_accounts\u003c/code\u003e in the managed configuration for the Google Play package.\u003c/p\u003e\n"],["\u003cp\u003eYou can specify which fields to update using the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter, otherwise all modifiable fields will be changed.\u003c/p\u003e\n"],["\u003cp\u003eThe request utilizes a PUT method and targets a specific URL structure including enterprise ID, user ID, and device ID.\u003c/p\u003e\n"],["\u003cp\u003eA successful operation returns a \u003ccode\u003eDevices\u003c/code\u003e resource, reflecting the updated device policy information.\u003c/p\u003e\n"]]],[],null,["# Devices: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates the device policy.\n\n\u003cbr /\u003e\n\n\nTo ensure the policy is properly enforced, you need to prevent unmanaged\naccounts from accessing Google Play by setting the\n`allowed_accounts` in the managed configuration for the Google\nPlay package. See [restrict\naccounts in Google Play](https://developer.android.com/work/dpc/security#google-play-accounts).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users/userId/devices/deviceId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `deviceId` | `string` | The ID of the device. |\n| `enterpriseId` | `string` | The ID of the enterprise. |\n| `userId` | `string` | The ID of the user. |\n| **Optional query parameters** |||\n| `updateMask` | `string` | Mask that identifies which fields to update. If not set, all modifiable fields will be modified. \u003cbr /\u003e When set in a query parameter, this field should be specified as `updateMask=\u003cfield1\u003e,\u003cfield2\u003e,...` |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Devices resource](/android/work/play/emm-api/v1/devices#resource).\n\nResponse\n--------\n\nIf successful, this method returns a [Devices resource](/android/work/play/emm-api/v1/devices#resource) in the response body."]]