Method: customers.devices.applyConfiguration

  • 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.

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.