सामान्य कार्रवाइयां

इस पेज पर कुछ ऐसे सामान्य कामों के उदाहरण दिए गए हैं जिन्हें आज़माया जा सकता है सामान्य Android रीसेलर लाइब्रेरी, जिसमें ये शामिल हैं:

ResellerService ऑब्जेक्ट बनाएं

ResellerService ऑब्जेक्ट बनाने के लिए, Samsung और Google की फ़ैक्ट्री क्लास का इस्तेमाल करें. ResellerService ऑब्जेक्ट के साथ, रजिस्टर करने के लिए तरीकों का एक सामान्य सेट उपलब्ध है Samsung और अन्य Android डिवाइस.

Samsung डिवाइस

नीचे दिए गए उदाहरण में, इसका इस्तेमाल करके ResellerService ऑब्जेक्ट बनाने का तरीका बताया गया है Samsung डिवाइसों को मैनेज करने के लिए SamsungResellerServiceFactory क्लास.

ऐसा करने से पहले, आपको शामिल होना होगा आपका वह नॉक्स डिप्लॉयमेंट प्रोग्राम (केडीपी) है.

ResellerService samsungResellerService = SamsungResellerServiceFactory.createResellerService(resellerId, serviceAccountKeyFilePath, clientIdentifier);

दूसरे Android डिवाइस

नीचे दिए गए उदाहरण में, इसका इस्तेमाल करके ResellerService ऑब्जेक्ट बनाने का तरीका बताया गया है अन्य (गैर-Samsung) Android को मैनेज करने के लिए GoogleResellerServiceFactory क्लास डिवाइस. ऐसा करने से पहले, आपको शुरू करने में दिए गए चरणों का पालन करना होगा पहले से तैयार डिवाइस के लिए resellerId और सेवा खाता कुंजी पाने के लिए.

ResellerService googleResellerService = GoogleResellerServiceFactory.createResellerService(resellerId, serviceAccountKeyFilePath);

Customer ऑब्जेक्ट बनाएं

Samsung और गैर-Samsung डिवाइस खरीदने वाले ग्राहक को दो ग्राहक आईडी की ज़रूरत होती है.

Samsung डिवाइस

Samsung डिवाइसों को मैनेज करने के लिए, ग्राहक के Knox ग्राहक आईडी का इस्तेमाल किया जाता है. पाने के लिए Knox ग्राहक आईडी, आपको पहले Customer ऑब्जेक्ट बनाना होगा. ऐसा करने के लिए, createCustomer को कॉल करने के लिए,SamsungResellerService SamsungResellerServiceFactory. यहां एक उदाहरण दिया गया है:

CreateCustomerRequest request = CreateCustomerRequest.newBuilder()
    .setCustomerName("TestCustomer") .addPrimaryEmails("superAdmin@gmail.com")
    .putVendorParams("country", "US") .putVendorParams("firstName", "Avery")
    .putVendorParams("lastName", "Yamada") .putVendorParams("service", "KME")
    .build();
CreateCustomerResponse response = samsungResellerService.createCustomer(request);
String companyId = response.getCustomer().getCompanyReference().getCompanyId();

अनुरोध पूरा होने पर, अनुरोध एक CreateCustomerResponse ऑब्जेक्ट दिखाता है, जिससे तो Knox ग्राहक आईडी एक्सट्रैक्ट किया जा सकता है.

दूसरे Android डिवाइस

अन्य Android डिवाइसों के लिए, ग्राहक को ज़ीरो-टच रजिस्ट्रेशन की सुविधा की ज़रूरत होती है ग्राहक आईडी अगर कोई ग्राहक पहले से ही, 'पहले से तैयार डिवाइस' सुविधा का इस्तेमाल किसी दूसरे ग्राहक पुनर्विक्रेता के लिए, आप उनके मौजूदा ग्राहक आईडी का उपयोग करते हैं. अगर ऐसा नहीं है, तो आपको एक Customer ऑब्जेक्ट. ऐसा करने के लिए, ResellerService का इस्तेमाल करके createCustomer पर कॉल करें GoogleResellerServiceFactory से बनाया गया. यहां एक उदाहरण दिया गया है:

CreateCustomerRequest request = CreateCustomerRequest.newBuilder()
    .setCustomerName("TestCustomer")
    .addPrimaryEmails("owner@gmail.com")
    .addSecondaryEmails("admin@gmail.com")
    .build();
CreateCustomerResponse response = googleResellerService.createCustomer(request);
String companyId = response.getCustomer().getCompanyReference().getCompanyId();

अनुरोध पूरा होने पर, अनुरोध CreateCustomerResponse ऑब्जेक्ट दिखाता है. आप तो रिस्पॉन्स में से ग्राहक आईडी को फिर से पाएं.

डिवाइसों के बैच पर दावा करें

किसी डिवाइस पर दावा करने से, डिवाइस और ग्राहक के बीच संबंध बन जाता है. इसके लिए उदाहरण के लिए, अगर आप किसी ग्राहक को डिवाइस का बैच बेचते हैं, तो आप अलग-अलग डिवाइस उपलब्ध हैं.

यह उदाहरण, डिवाइस के उस बैच को प्रोसेस करने का एक तरीका बताता है जिसमें कई निर्माताओं से डिवाइस के ऑर्डर (Samsung और अन्य Android) डिवाइस) पर उपलब्ध है.

पहला चरण: डिवाइसों और ग्राहकों को व्यवस्थित करना

नीचे दी गई टेबल में डिवाइस के IMEIs, मैन्युफ़ैक्चरर, और आईडी मौजूद होते हैं. को डिवाइस बेचे गए थे, ऑर्डर मैनेज करने का एक तरीका यह है कि उन्हें दो हिस्सों में व्यवस्थित किया जाए सूचियां: Samsung डिवाइस के ऑर्डर और Android (गैर-Samsung) डिवाइस के अन्य ऑर्डर. फिर, हर सूची के लिए, ग्राहकों के हिसाब से डिवाइस का ग्रुप बनाएं. उदाहरण के लिए:

Samsung डिवाइस

ग्राहक का नाम Samsung Knox ग्राहक आईडी मैन्युफ़ैक्चरर IMEI
ABC corp 11 Samsung

1234567801

1234567802

दूसरे Android डिवाइस

ग्राहक का नाम ग्राहक आईडी मैन्युफ़ैक्चरर IMEI
ABC corp 21 Google 1234567803
XYZ कॉर्पोरेशन 22 Sony

1234567804

1234567805

दूसरा चरण: ClaimDevicesRequest ऑब्जेक्ट बनाना

Samsung डिवाइस

// Note: You can only claim devices for a single customer in each request.
ClaimDevicesRequest claimSamsungDevicesRequest = ClaimDevicesRequest.newBuilder()
   .addClaims(
       DeviceClaim.newBuilder()
           .setCustomer(
               CompanyReference.newBuilder()
                   .setVendor(Vendor.SAMSUNG)
                   .setCompanyId("11")
                   .build())
           .setDeviceIdentifier(
               DeviceIdentifier.newBuilder()
                   .setImei("1234567801")
                   .setManufacturer("Samsung")
                   .build())
       .build())
   .addClaims(
       DeviceClaim.newBuilder()
           .setCustomer(
               CompanyReference.newBuilder()
                   .setVendor(Vendor.SAMSUNG)
                   .setCompanyId("11")
                   .build())
           .setDeviceIdentifier(
               DeviceIdentifier.newBuilder()
                   .setImei("1234567802")
                   .setManufacturer("Samsung")
                   .build())
           .build())
   .build();

दूसरे Android डिवाइस

ClaimDevicesRequest claimGoogleDevicesRequest = ClaimDevicesRequest.newBuilder()
    .addClaims(
        DeviceClaim.newBuilder()
            .setCustomer(
                CompanyReference.newBuilder()
                    .setVendor(Vendor.GOOGLE)
                    .setCompanyId("21")
                    .build())
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567803")
                    .setManufacturer("Google")
                    .build())
            .build())
    .addClaims(
        DeviceClaim.newBuilder()
            .setCustomer(
                CompanyReference.newBuilder()
                    .setVendor(Vendor.GOOGLE)
                    .setCompanyId("22")
                    .build())
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567804")
                    .setManufacturer("Sony")
                    .build())
            .build())
    .addClaims(
         DeviceClaim.newBuilder()
             .setCustomer(
                 CompanyReference.newBuilder()
                     .setVendor(Vendor.GOOGLE)
                     .setCompanyId("22")
                     .build())
             .setDeviceIdentifier(
                 DeviceIdentifier.newBuilder()
                     .setImei("1234567805")
                     .setManufacturer("Sony")
                     .build())
             .build())
    .build();

तीसरा चरण: ग्राहकों के लिए डिवाइसों पर दावा करना

ग्राहकों के लिए डिवाइसों पर दावा करने के लिए, ClaimDevicesAsync पर कॉल करें. यह उदाहरण दो अलग-अलग अनुरोधों की ज़रूरत होती है: एक Samsung ResellerService ऑब्जेक्ट से और एक Google ResellerService ऑब्जेक्ट से मिला है.

// Samsung devices
ClaimDevicesResponse samsungResponse = samsungResellerService.claimDevicesAsync(claimSamsungDevicesRequest);

// Other Android devices
ClaimDevicesResponse googleResponse = googleResellerService.claimDevicesAsync(claimGoogleDevicesRequest);

ClaimDevicesAsync अनुरोध, Operation ऑब्जेक्ट की सूची दिखाता है, जो उसमें अनुरोध की स्थिति मौजूद हो (जारी है, पूरा हो चुका है, गड़बड़ियों के साथ पूरा हुआ है, या विफल). किसी कार्रवाई की स्थिति देखने के लिए (उदाहरण के लिए, अगर रिस्पॉन्स IN_PROGRESS लौटाया गया), getOperation को कॉल करें.

// Samsung devices
GetOperationRequest samsungOperationRequest = GetOperationRequest.newBuilder().setOperationId(samsungOperationId).build();
Operation samsungOperation = samsungResellerService.getOperation(samsungOperationRequest);

// Other Android devices
GetOperationRequest googleOperationRequest = GetOperationRequest.newBuilder().setOperationId(googleOperationId).build();
Operation googleOperation = googleResellerService.getOperation(googleOperationRequest);

डिवाइसों के बैच पर दावा करें

डिवाइस पर दावा करने से वह ग्राहक से हट जाता है. आप अगर डिवाइस का ऑर्डर रद्द हो जाता है या डिवाइस पूरे नहीं किए जा सके. डिवाइसों के बैच से दावा करने के लिए, यह तरीका अपनाएं:

पहला चरण: UnclaimDevicesRequest ऑब्जेक्ट बनाना

Samsung डिवाइस

// Each request can only unclaim devices belonging to a single customer. The request must also
// include the customer's Samsung Knox customer ID.
UnclaimDevicesRequest unclaimSamsungDevicesRequest = UnclaimDevicesRequest.newBuilder()
    .putVendorParams("customerId", "11")
    .addUnclaims(
        DeviceUnclaim.newBuilder()
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567801")
                    .build())
        .build())
    .addUnclaims(
        DeviceUnclaim.newBuilder()
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567802")
                    .build())
            .build())
    .build();

दूसरे Android डिवाइस

UnclaimDevicesRequest unclaimGoogleDevicesRequest = UnclaimDevicesRequest.newBuilder()
    .addUnclaims(
        DeviceUnclaim.newBuilder()
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567803")
                    .build())
            .build())
    .addUnclaims(
        DeviceUnclaim.newBuilder()
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567804")
                    .build())
            .build())
    .addUnclaims(
        DeviceUnclaim.newBuilder()
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567805")
                    .build())
            .build())
    .build();

दूसरा चरण: डिवाइसों पर दावा करना

डिवाइसों से दावा हटाने के लिए, UnclaimDevicesAsync पर कॉल करें. इस उदाहरण के लिए दो अलग अनुरोध: एक Samsung ResellerService ऑब्जेक्ट से और एक Google ResellerService ऑब्जेक्ट.

UnclaimDevicesResponse samsungResponse = samsungResellerService.unclaimDevicesAsync(unclaimSamsungDevicesRequest);
UnclaimDevicesResponse googleResponse = googleResellerService.unclaimDevicesAsync(unclaimGoogleDevicesRequest);

UnclaimDevicesAsync अनुरोध, Operation ऑब्जेक्ट की सूची दिखाता है, जो उसमें अनुरोध की स्थिति मौजूद हो (जारी है, पूरा हो चुका है, गड़बड़ियों के साथ पूरा हुआ है, या नहीं) किसी कार्रवाई की स्थिति देखने के लिए (उदाहरण के लिए, अगर रिस्पॉन्स IN_PROGRESS वापस मिली), getOperation को कॉल करें.

Samsung डिवाइस

GetOperationRequest samsungOperationRequest = GetOperationRequest.newBuilder().setOperationId(samsungOperationId).build();
Operation samsungOperation = samsungResellerService.getOperation(samsungOperationRequest);

दूसरे Android डिवाइस

GetOperationRequest googleOperationRequest = GetOperationRequest.newBuilder().setOperationId(googleOperationId).build();
Operation googleOperation = googleResellerService.getOperation(googleOperationRequest);

Samsung डिवाइस को एक्सचेंज करना

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

पहला चरण: UnclaimDeviceRequest ऑब्जेक्ट बनाना

// Note: The request must include the customer's Samsung Knox customer ID.
UnclaimDevicesRequest unclaimSamsungDevicesRequest = UnclaimDevicesRequest.newBuilder()
    .putVendorParams("customerId", "11")
    .addUnclaims(
        DeviceUnclaim.newBuilder()
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567801")
                    .build())
        .build())
    .build();

दूसरा चरण: UnclaimDeviceAsync पर कॉल करें

UnclaimDevicesResponse samsungResponse = samsungResellerService.unclaimDevicesAsync(unclaimSamsungDevicesRequest);

UnclaimDevicesAsync अनुरोध, Operation ऑब्जेक्ट की सूची दिखाता है, जो इसमें अनुरोध की स्थिति शामिल है (यह प्रोसेस जारी है, पूरा हुआ, गड़बड़ियों के साथ पूरा हुआ, या विफल). किसी कार्रवाई की स्थिति देखने के लिए (उदाहरण के लिए, अगर रिस्पॉन्स IN_PROGRESS लौटाया गया), getOperation को कॉल करें:

GetOperationRequest samsungOperationRequest = GetOperationRequest.newBuilder().setOperationId(samsungOperationId).build();
Operation samsungOperation = samsungResellerService.getOperation(samsungOperationRequest);

तीसरा चरण: ClaimDeviceRequest ऑब्जेक्ट बनाना

ClaimDevicesRequest claimSamsungDevicesRequest = ClaimDevicesRequest.newBuilder()
   .addClaims(
       DeviceClaim.newBuilder()
           .setCustomer(
               CompanyReference.newBuilder()
                   .setVendor(Vendor.SAMSUNG)
                   .setCompanyId("11")
                   .build())
           .setDeviceIdentifier(
               DeviceIdentifier.newBuilder()
                   .setImei("1234567806")
                   .setManufacturer("Samsung")
                   .build())
       .build())
   .build();

चौथा चरण: ClaimDeviceAsync पर कॉल करें

ClaimDevicesResponse samsungResponse = samsungResellerService.claimDevicesAsync(claimSamsungDevicesRequest);

ClaimDevicesAsync अनुरोध, Operation ऑब्जेक्ट की सूची दिखाता है, जो इसमें अनुरोध की स्थिति शामिल है (यह प्रोसेस जारी है, पूरा हुआ, गड़बड़ियों के साथ पूरा हुआ, या विफल). किसी कार्रवाई की स्थिति देखने के लिए (उदाहरण के लिए, अगर रिस्पॉन्स IN_PROGRESS लौटाया गया), getOperation को कॉल करें:

GetOperationRequest samsungOperationRequest = GetOperationRequest.newBuilder().setOperationId(samsungOperationId).build();
Operation samsungOperation = samsungResellerService.getOperation(samsungOperationRequest);

Android (गैर-Samsung) डिवाइस का एक्सचेंज करना

अगर किसी वजह से डिवाइस को बदलना ज़रूरी है, तो आपके पास उसे बदलने का विकल्प होता है. यह उदाहरण के लिए, किसी Android (गैर-Samsung) डिवाइस को कोई दूसरा Android (गैर-Samsung) डिवाइस.

पहला चरण: UnclaimDeviceRequest ऑब्जेक्ट बनाना

UnclaimDeviceRequest unclaimGoogleDeviceRequest = UnclaimDeviceRequest.newBuilder()
    .setUnclaim(
        DeviceUnclaim.newBuilder()
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567803")
                    .build())
            .build())
    .build();

दूसरा चरण: UnclaimDevice पर कॉल करें

googleResponse = googleResellerService.unclaimDevice(unclaimGoogleDeviceRequest);

तीसरा चरण: ClaimDeviceRequest ऑब्जेक्ट बनाना

ClaimDeviceRequest claimGoogleDeviceRequest = ClaimDeviceRequest.newBuilder()
    .setClaim(
        DeviceClaim.newBuilder()
            .setCustomer(
                CompanyReference.newBuilder()
                    .setVendor(Vendor.GOOGLE)
                    .setCompanyId("21")
                    .build())
            .setDeviceIdentifier(
                DeviceIdentifier.newBuilder()
                    .setImei("1234567807")
                    .setManufacturer("Google")
                    .build())
            .build())
       .build();

चौथा चरण: ClaimDevice पर कॉल करें

ClaimDeviceResponse response = googleResellerService.claimDevice(claimGoogleDeviceRequest);

सफल होने पर, कॉल एक ClaimDeviceResponse ऑब्जेक्ट दिखाता है, जिसमें deviceId. ऐसा न करने पर, गड़बड़ी कोड वाला एक सामान्य अपवाद दिखता है.