Method: partners.devices.claim

המערכת טוענת את המכשיר של לקוח ומוסיפה אותו להרשמה דרך הארגון. אם הלקוח כבר הצהיר בעלות על המכשיר, השיחה תחזיר שגיאה.

בקשת HTTP

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:claim

כתובת ה-URL משתמשת בתחביר gRPC קידוד מחדש.

פרמטרים של נתיב

פרמטרים
partnerId

string (int64 format)

חובה. המזהה של שותף המפיץ.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "deviceIdentifier": {
    object (DeviceIdentifier)
  },
  "sectionType": enum (DeviceProvisioningSectionType),
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "preProvisioningToken": string,
  // Union field customer can be only one of the following:
  "customerId": string,
  "googleWorkspaceCustomerId": string
  // End of list of possible types for union field customer.
}
שדות
deviceIdentifier

object (DeviceIdentifier)

חובה. חובה. מזהה המכשיר שיש לתבוע עליו בעלות.
sectionType

enum (DeviceProvisioningSectionType)

חובה. סוג הקטע ברשומת ניהול התצורה של המכשיר.
deviceMetadata

object (DeviceMetadata)

אופציונלי. המטא-נתונים לצירוף למכשיר.
preProvisioningToken

string

אופציונלי. חובה להגדיר מכשירי Chrome OS בלבד.
שדה איחוד customer. חובה. הלקוח שבשמו נתבעה בעלות על המכשיר. customer יכול להיות רק אחד מהבאים:
customerId

string (int64 format)

המזהה של הלקוח שעבורו נתבעה בעלות על המכשיר.
googleWorkspaceCustomerId

string

מספר הלקוח ב-Google Workspace.

גוף התשובה

אם התגובה הצליחה, גוף התגובה מכיל נתונים במבנה הבא:

הודעת תגובה שמכילה את מזהה המכשיר של התלונה.

ייצוג JSON 
{
  "deviceId": string,
  "deviceName": string
}
שדות
deviceId

string (int64 format)

מזהה המכשיר של המכשיר שנתבעה עליו בעלות.
deviceName

string

שם המשאב של המכשיר בפורמט partners/[PARTNER_ID]/devices/[DEVICE_ID].

היקפי הרשאה

ההגדרה הזו מחייבת את היקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/androidworkprovisioning

למידע נוסף, עיינו בסקירה כללית על OAuth 2.0.