Method: customers.devices.applyConfiguration
המערכת מחילה הגדרות אישיות על המכשיר כדי לרשום את המכשיר להרשמה דרך הארגון. אחרי שמחילים הגדרות אישיות על המכשיר, המכשיר מקצה את עצמו באופן אוטומטי בהפעלה הראשונה או באיפוס הבא להגדרות המקוריות.
בקשת HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:applyConfiguration
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים |
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 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 2024-08-21 (שעון 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"]]