Method: customers.devices.applyConfiguration
Applies 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.
HTTP request
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:applyConfiguration
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
Required. The customer managing the device. An API resource name in the format customers/[CUSTOMER_ID].
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"device": {
object (DeviceReference)
},
"configuration": string
} |
| Fields |
device |
object (DeviceReference)
Required. The device the configuration is applied to.
|
configuration |
string
Required. The configuration applied to the device in the format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID].
|
Response body
If successful, the response body is empty.
Authorization Scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/androidworkzerotouchemm
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 2024-08-07 UTC.
[null,null,["Last updated 2024-08-07 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"]]