Method: customers.devices.applyConfiguration
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Wendet eine Konfiguration auf das Gerät an, um es für die Zero-Touch-Registrierung zu registrieren. Nachdem eine Konfiguration auf ein Gerät angewendet wurde, stellt sich das Gerät beim ersten Start oder beim nächsten Zurücksetzen auf die Werkseinstellungen automatisch selbst bereit.
HTTP-Anfrage
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:applyConfiguration
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Der Kunde, der das Gerät verwaltet. Ein API-Ressourcenname im Format customers/[CUSTOMER_ID].
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| JSON-Darstellung |
{
"device": {
object (DeviceReference)
},
"configuration": string
} |
| Felder |
device |
object (DeviceReference)
Erforderlich. Das Gerät, auf das die Konfiguration angewendet wird.
|
configuration |
string
Erforderlich. Die auf das Gerät angewendete Konfiguration im Format customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID].
|
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidworkzerotouchemm
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
