चीज़ें

कंपनी का रेफ़रंस

किसी कंपनी की खास पहचान करता है.

फ़ील्ड का नाम डेटा किस तरह का है ब्यौरा
companyId string सिर्फ़ आउटपुट. सर्वर का असाइन किया गया कंपनी का आईडी.
vendor enum Samsung या Google.

कंपनी

एक कंपनी का प्रतिनिधित्व करता है.

फ़ील्ड का नाम डेटा किस तरह का है ब्यौरा
companyReference object(CompanyReference) कंपनी का संदर्भ ऑब्जेक्ट.
companyName string कंपनी का नाम. उदाहरण के लिए, XYZ Corp. यह कंपनी के कर्मचारियों को पहले से तैयार डिवाइस वाले पोर्टल पर दिखता है.
vendorParams map वेंडर की ओर से तय किए गए की-वैल्यू पेयर में ज़्यादा फ़ील्ड.

डिवाइस

नाम दर्ज करने के लिए रजिस्टर किया गया Android डिवाइस.

फ़ील्ड का नाम डेटा किस तरह का है ब्यौरा
deviceId string सिर्फ़ आउटपुट. डिवाइस का आईडी, जो सर्वर ने असाइन किया है.
deviceIdentifier object(DeviceIdentifier) हार्डवेयर आईडी से, बनाए गए डिवाइस की पहचान होती है.
customer object(CompanyReference) कंपनी आईडी, जिससे पता चलता है कि डिवाइस किस कंपनी को असाइन किए गए हैं.
orderNumber string ऑर्डर नंबर.
vendorParams map वेंडर की ओर से तय किए गए की-वैल्यू पेयर में ज़्यादा फ़ील्ड.

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

मैन्युफ़ैक्चरर के डिवाइस की पहचान करने के लिए, हार्डवेयर और प्रॉडक्ट आईडी को एन्क्रिप्ट (सुरक्षित) करता है.

Samsung डिवाइसों के लिए इनमें से एक फ़ील्ड ज़रूरी है:

  • IMEI
  • serialNumber
  • meid

model जैसे दूसरे सभी फ़ील्ड को अनदेखा कर दिया जाता है.

अन्य सभी Android डिवाइसों के लिए:

  • सेल्युलर डिवाइसों को imei और manufacturer की ज़रूरत होती है.
  • सिर्फ़ वाई-फ़ाई डिवाइसों का इस्तेमाल करने के लिए, serialNumber, manufacturer, और model की ज़रूरत होती है.
फ़ील्ड का नाम डेटा किस तरह का है ब्यौरा
imei string डिवाइस का IMEI नंबर. इनपुट पर पुष्टि की गई.
serialNumber string डिवाइस बनाने वाली कंपनी का सीरियल नंबर. हो सकता है कि अलग-अलग डिवाइस मॉडल के लिए यह वैल्यू यूनीक न हो.
meid string डिवाइस का MEID नंबर.
manufacturer string डिवाइस बनाने वाली कंपनी का नाम. डिवाइस में पहले से मौजूद वैल्यू, android.os.Build.MANUFACTURER से मिलती-जुलती है. जिन वैल्यू की अनुमति है वे मैन्युफ़ैक्चरर में दी गई हैं.
model string डिवाइस के मॉडल का नाम. डिवाइस में पहले से मौजूद वैल्यू, android.os.Build.MODEL से मिलती-जुलती है. जिन वैल्यू की अनुमति है वे मॉडल में दी गई हैं.

कार्रवाई

इस संसाधन में एसिंक्रोनस एपीआई कॉल की स्थिति है. चार स्थितियां हो सकती हैं:

  • IN_PROGRESS: कार्रवाई चल रही है.
  • COMPLETE: सभी डिवाइस प्रोसेस हो गए.
  • COMPLETE_WITH_ERRORS: कार्रवाई पूरी हो गई थी, लेकिन कुछ गड़बड़ियां हुईं. deviceErrors गड़बड़ियों की सूची में सभी गड़बड़ियां हैं.
  • FAILED कार्रवाई पूरी नहीं हुई और operationId नहीं दिखाया गया.
फ़ील्ड का नाम डेटा किस तरह का है ब्यौरा
operationId string कार्रवाई आईडी, इससे पहले samsung/ या google/ लगाया गया है. अगर खाली है, तो state, FAILED है.
operationType enum(operationType) कार्रवाई का टाइप: CLAIM_DEVICES या UNCLAIM_DEVICES.
state enum(operationState) ऑपरेशन की स्थिति: IN_PROGRESS, COMPLETE, COMPLETE_WITH_ERRORS, FAILED.
deviceErrors object(DeviceOperationError) की सूची डिवाइस की कार्रवाई से जुड़ी गड़बड़ियों की सूची.
vendorParams map वेंडर की ओर से तय किए गए की-वैल्यू पेयर में ज़्यादा फ़ील्ड.

डिवाइस-ऑपरेशन गड़बड़ी

Operation में डिवाइस के हिसाब से गड़बड़ी. हर संसाधन में deviceId और deviceIdentifier एक ही होते हैं. इनकी मदद से, कार्रवाई शुरू की जा सकती है.

फ़ील्ड का नाम डेटा किस तरह का है ब्यौरा
deviceId string सिर्फ़ आउटपुट. डिवाइस का आईडी, जो सर्वर ने असाइन किया है.
deviceIdentifier object(DeviceIdentifier) हार्डवेयर आईडी से, बनाए गए डिवाइस की पहचान होती है.
error object(Error) डिवाइस संचालन गड़बड़ी.

कॉमन अपवाद

अपवाद, जिसे सभी सिंक्रोनस एपीआई इस्तेमाल कर सकते हैं.

प्रॉपर्टी का नाम वैल्यू ब्यौरा
error object(Error) सिंक करने के दौरान गड़बड़ी हुई.

गड़बड़ी

किसी गड़बड़ी के बारे में जानकारी देने वाला ऑब्जेक्ट.

प्रॉपर्टी का नाम वैल्यू ब्यौरा
code enum(ErrorCode) गड़बड़ी कोड. उदाहरण के लिए, INVALID_REQUESET या PERMISSION_DENIED
message string गड़बड़ी का मैसेज.
vendorMsg string विक्रेता से हुई गड़बड़ी की पूरी जानकारी.
errorId string अंदरूनी गड़बड़ी का पहचानकर्ता.
vendorParams map वेंडर की ओर से तय किए गए की-वैल्यू पेयर में ज़्यादा फ़ील्ड.

गड़बड़ी कोड

सामान्य गड़बड़ियां.

Enum ब्यौरा
INVALID_PARAM_DEFAULT अमान्य इनपुट पैरामीटर. ज़्यादा जानकारी के लिए, विक्रेता Msg देखें.
INVALID_PAGE_TOKEN दिया गया pageToken अमान्य है.
INVALID_CUSTOMER_ID दिया गया ग्राहक आईडी अमान्य है.
INVALID_DEVICE_IMEI गलत IMEI.
INVALID_DEVICE_MEID अमान्य MEID.
INVALID_DEVICE_SERIAL अमान्य सीरियल नंबर.
INVALID_OPERATION_ID यह ऑपरेशन आईडी अमान्य है.
INVALID_RESELLER_ID दिया गया रीसेलर आईडी अमान्य है.
INVALID_MANUFACTURER दिया गया निर्माता अमान्य है / काम नहीं करता है.
INVALID_IDENTIFIER_SET दिए गए आइडेंटिफ़ायर का सेट, अनुरोध के लिए काफ़ी नहीं है. अनुमति वाले आइडेंटिफ़ायर सेट के बारे में ज़्यादा जानकारी के लिए, DeviceIdentifier देखें.
INVALID_MODEL दिया गया मॉडल अमान्य है / काम नहीं करता है.
INVALID_DEVICE_ID दिया गया deviceId अमान्य है.
INVALID_DEVICE दिया गया डिवाइस मौजूद नहीं है. यह Samsung का खास गड़बड़ी कोड है.
DUPLICATE_DEVICE डिवाइस पर पहले भी इसी ग्राहक ने दावा किया था. किसी सुधार की ज़रूरत नहीं है.
DEVICE_UPLOAD_COUNT_EXCEEDED अनुरोध में ऐसे और डिवाइस शामिल हैं जिनकी सीमा तय है (फ़िलहाल 1 लाख है).
AUTHORIZATION_FAIL आपके पास किसी दिए गए संसाधन (जैसे डिवाइस, ग्राहक) का ऐक्सेस नहीं है, या संसाधन मौजूद नहीं है. ज़्यादा जानकारी के लिए, vendorMsg पर जाएं.
INTERNAL_SERVER_ERROR सर्वर की ऐसी गड़बड़ी जिसकी जानकारी नहीं है. ज़्यादा जानकारी के लिए, विक्रेता Msg देखें. सर्वर की गड़बड़ी के हिसाब से, इन अनुरोधों की फिर से कोशिश की जा सकती है.
NOT_IMPLEMENTED अनुरोध करने का तरीका सर्वर पर काम नहीं करता.