Method: customers.devices.applyConfiguration
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
پیکربندی را برای ثبت دستگاه برای ثبت نام بدون لمس روی دستگاه اعمال می کند. پس از اعمال یک پیکربندی بر روی یک دستگاه، دستگاه به طور خودکار خود را در اولین راه‌اندازی یا بازنشانی کارخانه‌ای بعدی آماده می‌کند.
درخواست HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:applyConfiguration
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. مشتری که دستگاه را مدیریت می کند. نام منبع API در قالب customers/[CUSTOMER_ID] . |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"device": {
object (DeviceReference)
},
"configuration": string
} |
| فیلدها |
|---|
device | object ( DeviceReference ) مورد نیاز. دستگاهی که پیکربندی روی آن اعمال می شود. |
configuration | string مورد نیاز. پیکربندی در قالب customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID] روی دستگاه اعمال شد. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ خالی است.
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/androidworkzerotouchemm
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
