Method: partners.devices.claim

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

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

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

यह यूआरएल 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 की खास जानकारी देखें.