Method: partners.devices.claim

ग्राहक के लिए डिवाइस का दावा करता है और उसे पहले से तैयार डिवाइस में जोड़ देता है. अगर डिवाइस पर पहले ही किसी दूसरे ग्राहक ने दावा किया है, तो कॉल में गड़बड़ी का मैसेज मिलता है.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
partnerId

string (int64 format)

ज़रूरी है. रीसेलर पार्टनर का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में नीचे दिए गए स्ट्रक्चर का डेटा शामिल है:

जेएसओएन के काेड में दिखाना 
{
  "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 ग्राहक आईडी.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जवाब का मैसेज, जिसमें दावे का डिवाइस आईडी हो.

जेएसओएन के काेड में दिखाना 
{
  "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 की खास जानकारी देखें.