Method: enterprises.devices.patch
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
PATCH https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
The name of the device in the form enterprises/{enterpriseId}/devices/{deviceId}.
|
Query parameters
| Parameters |
updateMask |
string (FieldMask format)
The field mask indicating the fields to update. If not set, all modifiable fields will be modified. This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
|
Request body
The request body contains an instance of Device.
Response body
If successful, the response body contains an instance of Device.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/androidmanagement
For more information, see the OAuth 2.0 Overview.
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 2025-02-19 UTC.
[null,null,["Last updated 2025-02-19 UTC."],[[["\u003cp\u003eUpdates a device using an HTTP PATCH request to a specific URL with required path and optional query parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eRequest and response bodies utilize the \u003ccode\u003eDevice\u003c/code\u003e object for data transfer.\u003c/p\u003e\n"],["\u003cp\u003ePath parameters specify the enterprise and device, while query parameters allow for selective field updates using a field mask.\u003c/p\u003e\n"],["\u003cp\u003eYou can find more details about the \u003ccode\u003eDevice\u003c/code\u003e object and authorization in the provided links.\u003c/p\u003e\n"]]],["This document details how to update a device using a PATCH request. The request URL structure is `https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}`, using gRPC Transcoding. The `name` path parameter specifies the device. The `updateMask` query parameter indicates which fields to modify. The request and response bodies use the `Device` object. Authorization requires the `https://www.googleapis.com/auth/androidmanagement` OAuth scope. The user can use the `Try it!` option to test the update.\n"],null,["# Method: enterprises.devices.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a device.\n\n### HTTP request\n\n`PATCH https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the device in the form `enterprises/{enterpriseId}/devices/{deviceId}`. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` The field mask indicating the fields to update. If not set, all modifiable fields will be modified. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [Device](/android/management/reference/rest/v1/enterprises.devices#Device).\n\n### Response body\n\nIf successful, the response body contains an instance of [Device](/android/management/reference/rest/v1/enterprises.devices#Device).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
