आइडेंटिफ़ायर

DeviceIdentifier में, बनाए गए डिवाइस की पहचान करने के लिए, हार्डवेयर आईडी को एन्क्रिप्ट (सुरक्षित) किया जाता है. इस दस्तावेज़ में बताया गया है कि 'पहले से तैयार डिवाइस' सुविधा वाले एपीआई में, आइडेंटिफ़ायर के साथ कैसे काम किया जाता है.

DeviceIdentifier किसी डिवाइस की खास तरह से पहचान करने के लिए, ज़रूरी हार्डवेयर मेटाडेटा या आईडी को मिलाता है.

पोर्टल के ज़रिए डिवाइस डेटा अपलोड करते समय या एपीआई को कॉल करते समय, डिवाइस आइडेंटिफ़ायर वैल्यू आपके संगठन में शामिल होती हैं. DeviceIdentifier इंस्टेंस में बदलाव नहीं किया जा सकता. इसलिए, फ़ील्ड की वैल्यू बदलने के लिए एपीआई का इस्तेमाल नहीं किया जा सकता.

ज़रूरी फ़ील्ड

Android डिवाइस

पहले से तैयार डिवाइस की पहचान आम तौर पर, IMEI (या MEID) सेल्युलर मॉडम आईडी से होती है. हालांकि, टैबलेट जैसे बिना सेल्युलर मॉडम वाले डिवाइसों पर काम करने के लिए, अलग-अलग फ़ील्ड का इस्तेमाल करके भी डिवाइसों को पहचाना जा सकता है. नीचे दी गई टेबल में हर तरह के डिवाइस के लिए ज़रूरी फ़ील्ड दिखाए गए हैं:

पहचानकर्ता सेल्यूलर सिर्फ़ वाई-फ़ाई ज़रूरी जानकारी
hardware_id यह फ़ील्ड कोई IMEI या MEID नंबर होना चाहिए. 'पहले से तैयार डिवाइस' सुविधा, एपीआई के आर्ग्युमेंट में IMEI की वैल्यू पास करने पर, उनके फ़ॉर्मैट की पुष्टि करती है. एक से ज़्यादा सेल्युलर मॉडम वाले डिवाइसों के लिए, ड्यूअल-सिम डिवाइस देखें.
serialNumber डिवाइस के लिए मैन्युफ़ैक्चरर का सीरियल नंबर. सीरियल नंबर, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होता है. यह वही वैल्यू होती है जो Build.getSerial() से मिलती है.
model डिवाइस मॉडल की वैल्यू, डिवाइस में मौजूद उस वैल्यू से मेल खानी चाहिए जो Build.MODEL से मिली है. हर मैन्युफ़ैक्चरर के लिए तय की गई वैल्यू की सूची देखने के लिए, मॉडल के नाम का रेफ़रंस देखें.
manufacturer 'पहले से तैयार डिवाइस' सुविधा सिर्फ़ वाई-फ़ाई डिवाइस पर काम करे, इसके लिए manufacturer फ़ील्ड की वैल्यू, डिवाइस की बिल्ट-इन वैल्यू से Build.MANUFACTURER से मेल खानी चाहिए. सेल्युलर डिवाइस के लिए manufacturer फ़ील्ड वैकल्पिक है, लेकिन इसका सुझाव दिया जाता है, क्योंकि इससे ग्राहक अपने डिवाइस को आसानी से पहचान सकते हैं. ज़्यादा जानकारी के लिए, मैन्युफ़ैक्चरर के नाम वाला रेफ़रंस देखें.

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

ड्यूअल-सिम डिवाइस

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

ChromeOS डिवाइस

ChromeOS डिवाइसों के लिए, मोबाइल और सिर्फ़ वाई-फ़ाई वाले डिवाइसों के लिए, ज़रूरी आइडेंटिफ़ायर एक ही होते हैं:

पहचानकर्ता ज़रूरी जानकारी
serialNumber डिवाइस के लिए मैन्युफ़ैक्चरर का सीरियल नंबर.
model डिवाइस मॉडल की वैल्यू, डिवाइस में मौजूद वैल्यू से मेल खानी चाहिए. रेफ़रंस के लिए, ChromeOS मॉडल वैल्यू की सूची देखें.
chromeOsAttestedDeviceId प्रमाणित किए गए डिवाइस का आईडी. रेफ़रंस के लिए, इस सुविधा के साथ काम करने वाले ChromeOS डिवाइसों की सूची देखें.

किसी डिवाइस के बारे में बताएं

डिवाइसों को ढूंढने या उन पर दावा करने के लिए, DeviceIdentifier का इस्तेमाल करें. आपको डिवाइस के टाइप के लिए तय किए गए ज़रूरी फ़ील्ड शामिल करने होंगे.

नीचे दिया गया स्निपेट, partners.devices.findByIdentifier पर कॉल करके किसी खास डिवाइस को खोजने के लिए इस्तेमाल किया गया IMEI नंबर दिखाता है:

Java

// Create a DeviceIdentifier.
DeviceIdentifier deviceIdentifier = new DeviceIdentifier();
deviceIdentifier.setImei("123456789012347");

// Perform the search using the zero-touch enrollment API.
FindDevicesByDeviceIdentifierRequest body = new FindDevicesByDeviceIdentifierRequest();
body.setLimit(1L);
body.setDeviceIdentifier(deviceIdentifier);

FindDevicesByDeviceIdentifierResponse response = service
    .partners()
    .devices()
    .findByIdentifier(PARTNER_ID, body)
    .execute();

.NET

// Create a DeviceIdentifier.
var deviceIdentifier = new DeviceIdentifier
{
    Imei = "123456789012347"
};

// Perform the search using the zero-touch enrollment API.
var body = new FindDevicesByDeviceIdentifierRequest
{
    Limit = 1,
    DeviceIdentifier = deviceIdentifier
};
var response = service.Partners.Devices.FindByIdentifier(body, PartnerId).Execute();

Python

# Create a DeviceIdentifier.
device_identifier = {'imei':'123456789012347'}

# Perform the search using the zero-touch enrollment API.
response = service.partners().devices().findByIdentifier(
    partnerId=PARTNER_ID, body={'deviceIdentifier':device_identifier, \
    'limit':1}).execute()

नीचे दिए गए स्निपेट में सिर्फ़ वाई-फ़ाई डिवाइस आइडेंटिफ़ायर बनाने का तरीका बताया गया है:

Java

// Create a device identifier to find a Wi-Fi-only device.
DeviceIdentifier deviceIdentifier = new DeviceIdentifier();
deviceIdentifier.setManufacturer("Honeywell");
deviceIdentifier.setModel("VM1A");
deviceIdentifier.setSerialNumber("ABcd1235678");

.NET

// Create a device identifier to find a Wi-Fi-only device.
var deviceIdentifier = new DeviceIdentifier
{
    Manufacturer = "Honeywell",
    Model = "VM1A",
    SerialNumber = "ABcd1235678"
};

Python

# Create a device identifier to find a Wi-Fi-only device.
device_identifier = {'manufacturer':'Honeywell', \
    'model':'VM1A', 'serialNumber':'ABcd1235678'}

ज़्यादा जानें