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 بهوقت ساعت هماهنگ جهانی."],[[["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"]]
