Method: customers.devices.applyConfiguration
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Applica una configurazione al dispositivo per registrarlo per la registrazione zero-touch. Dopo aver applicato una configurazione a un dispositivo, quest'ultimo esegue automaticamente il provisioning al primo avvio o al successivo ripristino dei dati di fabbrica.
Richiesta HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:applyConfiguration
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
| Parametri |
parent |
string
Obbligatorio. Il cliente che gestisce il dispositivo. Un nome di risorsa API nel formato customers/[CUSTOMER_ID].
|
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
| Rappresentazione JSON |
{
"device": {
object (DeviceReference)
},
"configuration": string
} |
| Campi |
device |
object (DeviceReference)
Obbligatorio. Il dispositivo a cui viene applicata la configurazione.
|
configuration |
string
Obbligatorio. La configurazione applicata al dispositivo nel formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID].
|
Corpo della risposta
In caso di esito positivo, il corpo della risposta è vuoto.
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/androidworkzerotouchemm
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 2025-07-25 UTC."],[[["\u003cp\u003eThis webpage details how to apply a configuration to a device for zero-touch enrollment, allowing automatic provisioning upon the first boot or after a factory reset.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves sending a POST request to a specific URL endpoint that includes the customer ID as a path parameter, \u003ccode\u003ecustomers/[CUSTOMER_ID]\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include both the device details and the configuration to be applied, which must be in the provided format \u003ccode\u003ecustomers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA successful request results in an empty response body, indicating that the configuration has been applied.\u003c/p\u003e\n"],["\u003cp\u003eUtilizing this functionality requires authorization using the OAuth scope: \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkzerotouchemm\u003c/code\u003e.\u003c/p\u003e\n"]]],["This describes applying a configuration to a device for zero-touch enrollment via a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:applyConfiguration`. The `parent` path parameter requires a customer ID. The request body mandates a `device` object and a `configuration` string, referencing the device and configuration. Upon success, an empty response is returned. This action requires the `https://www.googleapis.com/auth/androidworkzerotouchemm` OAuth scope.\n"],null,["# Method: customers.devices.applyConfiguration\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nApplies a Configuration to the device to register the device for zero-touch enrollment. After applying a configuration to a device, the device automatically provisions itself on first boot, or next factory reset.\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:applyConfiguration`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The customer managing the device. An API resource name in the format `customers/[CUSTOMER_ID]`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"device\": { object (/zero-touch/reference/customer/rest/v1/DeviceReference) }, \"configuration\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| `device` | `object (`[DeviceReference](/zero-touch/reference/customer/rest/v1/DeviceReference)`)` Required. The device the configuration is applied to. |\n| `configuration` | `string` Required. The configuration applied to the device in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization 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)."]]
