Method: enterprises.policies.patch
Stay organized with collections
Save and categorize content based on your preferences.
Updates or creates a policy.
HTTP request
PATCH https://androidmanagement.googleapis.com/v1/{name=enterprises/*/policies/*}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
name |
string
The name of the policy in the form enterprises/{enterpriseId}/policies/{policyId} .
|
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 Policy
.
Response body
If successful, the response body contains an instance of Policy
.
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\u003eThis operation updates or creates an enterprise policy using a PATCH request to the specified URL.\u003c/p\u003e\n"],["\u003cp\u003eThe request must include path and query parameters to identify the target policy and specify fields to update.\u003c/p\u003e\n"],["\u003cp\u003eBoth request and response bodies utilize the \u003ccode\u003ePolicy\u003c/code\u003e object for data transfer.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes how to update or create a policy using a PATCH HTTP request to a specific URL. The URL path, including the enterprise and policy IDs, is defined by `name`. Optional `updateMask` query parameter specifies which policy fields to modify. The request and response bodies both utilize the `Policy` data structure. Authorization requires the `https://www.googleapis.com/auth/androidmanagement` OAuth scope. The provided document details the URL structure, required parameters, and body content.\n"],null,["# Method: enterprises.policies.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 or creates a policy.\n\n### HTTP request\n\n`PATCH https://androidmanagement.googleapis.com/v1/{name=enterprises/*/policies/*}`\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 policy in the form `enterprises/{enterpriseId}/policies/{policyId}`. |\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 [Policy](/android/management/reference/rest/v1/enterprises.policies#Policy).\n\n### Response body\n\nIf successful, the response body contains an instance of [Policy](/android/management/reference/rest/v1/enterprises.policies#Policy).\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)."]]