Method: customers.configurations.patch
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Actualiza los valores de campo de una configuración.
Solicitud HTTP
PATCH https://androiddeviceprovisioning.googleapis.com/v1/{configuration.name=customers/*/configurations/*}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
configuration.name |
string
Solo salida. El nombre del recurso de la API en el formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. El servidor lo asigna.
|
Parámetros de consulta
| Parámetros |
updateMask |
string (FieldMask format)
Obligatorio. La máscara de campo que se aplica al Configuration de destino antes de actualizar los campos. Para obtener más información sobre el uso de máscaras de campo, consulta FieldMask en la documentación de búferes de protocolo. Esta es una lista separada por comas de los nombres de campos totalmente calificados. Ejemplo: "user.displayName,photo".
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Configuration.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Configuration.
Alcances de la autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/androidworkzerotouchemm
Para obtener más información, consulta la descripción general de OAuth 2.0.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eThis endpoint updates a configuration's field values using a PATCH request.\u003c/p\u003e\n"],["\u003cp\u003eThe request URL requires the \u003ccode\u003econfiguration.name\u003c/code\u003e as a path parameter in the format \u003ccode\u003ecustomers/*/configurations/*\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt utilizes \u003ccode\u003eupdateMask\u003c/code\u003e as a required query parameter to specify which fields of the \u003ccode\u003eConfiguration\u003c/code\u003e should be updated, following FieldMask format.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain an instance of \u003ccode\u003eConfiguration\u003c/code\u003e, and a successful response will also return an instance of \u003ccode\u003eConfiguration\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkzerotouchemm\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes updating configuration field values via a PATCH request to a specific URL: `https://androiddeviceprovisioning.googleapis.com/v1/{configuration.name=customers/*/configurations/*}`. The `configuration.name` in the URL is a required path parameter. The `updateMask` query parameter, using FieldMask format, is required to specify which fields to update. The request and response bodies use the `Configuration` resource. Authorization requires the `https://www.googleapis.com/auth/androidworkzerotouchemm` OAuth scope.\n"],null,["- [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\nUpdates a configuration's field values.\n\nHTTP request\n\n`PATCH https://androiddeviceprovisioning.googleapis.com/v1/{configuration.name=customers/*/configurations/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------|\n| `configuration.name` | `string` Output only. The API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by the server. |\n\nQuery parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. The field mask applied to the target `Configuration` before updating the fields. To learn more about using field masks, read [FieldMask](/protocol-buffers/docs/reference/google.protobuf#fieldmask) in the Protocol Buffers documentation. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\nRequest body\n\nThe request body contains an instance of [Configuration](/zero-touch/reference/customer/rest/v1/customers.configurations#Configuration).\n\nResponse body\n\nIf successful, the response body contains an instance of [Configuration](/zero-touch/reference/customer/rest/v1/customers.configurations#Configuration).\n\nAuthorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkzerotouchemm`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
