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

זה שינוי אופציונלי. חובה וניתן להגדיר רק למכשירי ChromeOS.

שדה איחוד 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.