Method: customers.devices.applyConfiguration
Aplica uma configuração ao dispositivo para registrá-lo no registro sem toque. Depois de aplicar uma configuração a um dispositivo, ele faz o provisionamento automaticamente na primeira inicialização ou na próxima redefinição para a configuração original.
Solicitação HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:applyConfiguration
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros |
parent |
string
Obrigatório. O cliente que gerencia o dispositivo. Um nome de recurso da API no formato customers/[CUSTOMER_ID] .
|
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
{
"device": {
object (DeviceReference )
},
"configuration": string
} |
Campos |
device |
object (DeviceReference )
Obrigatório. O dispositivo ao qual a configuração é aplicada.
|
configuration |
string
Obrigatório. É a configuração aplicada ao dispositivo no formato customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] .
|
Corpo da resposta
Se a solicitação for concluída, o corpo da resposta estará vazio.
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/androidworkzerotouchemm
Para mais informações, consulte a Visão geral do OAuth 2.0.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-08-21 UTC.
[null,null,["Última atualização 2024-08-21 UTC."],[[["This 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."],["The process involves sending a POST request to a specific URL endpoint that includes the customer ID as a path parameter, `customers/[CUSTOMER_ID]`."],["The request body must include both the device details and the configuration to be applied, which must be in the provided format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`."],["A successful request results in an empty response body, indicating that the configuration has been applied."],["Utilizing this functionality requires authorization using the OAuth scope: `https://www.googleapis.com/auth/androidworkzerotouchemm`."]]],["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"]]