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