המערכת טוענת את המכשיר של לקוח ומוסיפה אותו להרשמה דרך הארגון. אם הלקוח כבר הצהיר בעלות על המכשיר, השיחה תחזיר שגיאה.
בקשת HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim
כתובת ה-URL משתמשת בתחביר gRPC קידוד מחדש.
פרמטרים של נתיב
פרמטרים | |
---|---|
partnerId |
חובה. המזהה של שותף המפיץ. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "deviceIdentifier": { object ( |
שדות | |
---|---|
deviceIdentifier |
חובה. חובה. מזהה המכשיר שיש לתבוע עליו בעלות. |
sectionType |
חובה. סוג הקטע ברשומת ניהול התצורה של המכשיר. |
deviceMetadata |
אופציונלי. המטא-נתונים לצירוף למכשיר. |
preProvisioningToken |
אופציונלי. חובה להגדיר מכשירי Chrome OS בלבד. |
שדה איחוד customer . חובה. הלקוח שבשמו נתבעה בעלות על המכשיר. customer יכול להיות רק אחד מהבאים: |
|
customerId |
המזהה של הלקוח שעבורו נתבעה בעלות על המכשיר. |
googleWorkspaceCustomerId |
מספר הלקוח ב-Google Workspace. |
גוף התשובה
אם התגובה הצליחה, גוף התגובה מכיל נתונים במבנה הבא:
הודעת תגובה שמכילה את מזהה המכשיר של התלונה.
ייצוג JSON |
---|
{ "deviceId": string, "deviceName": string } |
שדות | |
---|---|
deviceId |
מזהה המכשיר של המכשיר שנתבעה עליו בעלות. |
deviceName |
שם המשאב של המכשיר בפורמט |
היקפי הרשאה
ההגדרה הזו מחייבת את היקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/androidworkprovisioning
למידע נוסף, עיינו בסקירה כללית על OAuth 2.0.