कंपनी का रेफ़रंस
किसी कंपनी की खास पहचान करता है.
फ़ील्ड का नाम | डेटा किस तरह का है | ब्यौरा |
---|---|---|
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 |
अनुरोध करने का तरीका सर्वर पर काम नहीं करता. |