ग्राहक बनाएं

Knox या ज़ीरो-टच रजिस्ट्रेशन के लिए, किसी कंपनी (ग्राहक) की खास पहचान करने के लिए Company ऑब्जेक्ट बनाता है. यह तरीका काम करने के बाद, बताए गए मालिक (primary_emails) या एडमिन (secondary_emails), अपने ईमेल पते को Google खाते से जोड़ सकते हैं. इससे, वे 'पहले से तैयार डिवाइस' सुविधा वाला कस्टमर पोर्टल ऐक्सेस कर सकते हैं. ज़्यादा जानकारी के लिए, आईटी एडमिन के लिए 'पहले से तैयार डिवाइस' सुविधा वाला रजिस्ट्रेशन लेख पढ़ें. इसके अलावा, Knox Mobile Enrollment (KME) पोर्टल को ऐक्सेस करने के लिए, वे अपने ईमेल पते को Samsung खाते से भी जोड़ सकते हैं.

तरीके का हस्ताक्षर

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

CreateCustomerRequest

प्रॉपर्टी का नाम	मान	ज़रूरी है	ब्यौरा
customer_name	string	हां	कंपनी का नाम. उदाहरण के लिए, XYZ Corp. यह नाम, कंपनी के कर्मचारियों को ज़ीरो-टच रजिस्ट्रेशन पोर्टल पर दिखता है.
primary_emails	object(string) की सूची	हां	ज़ीरो-टच: मालिक की भूमिका में मौजूद ग्राहक के उपयोगकर्ताओं का ईमेल पता. कम से कम एक ईमेल पता डालना ज़रूरी है. हर ईमेल पता किसी Google खाते से जुड़ा होना चाहिए. मालिकों के पास वही ऐक्सेस होता है जो एडमिन के पास होता है. हालांकि, वे आपके संगठन के पोर्टल के उपयोगकर्ताओं को जोड़ सकते हैं, हटा सकते हैं, और उनके ऐक्सेस लेवल में बदलाव कर सकते हैं. Samsung: ग्राहक के सुपर एडमिन का ईमेल पता. Samsung, सूची में मौजूद सिर्फ़ पहले ईमेल का इस्तेमाल करता है. ईमेल पता, किसी Samsung खाते से जुड़ा होना चाहिए.
secondary_emails	object(string) की सूची	नहीं	एडमिन की भूमिका वाले ग्राहक के उपयोगकर्ताओं का ईमेल पता. हर ईमेल पता किसी Google खाते से जुड़ा होना चाहिए. ध्यान दें: Samsung पर इस प्रॉपर्टी का इस्तेमाल नहीं किया जा सकता.
vendorParams	map	पहले से तैयार डिवाइस: नहीं Samsung: हां	अतिरिक्त फ़ील्ड, वेंडर की ओर से तय किया गया की-वैल्यू पेयर. SamsungResellerService क्लास के अनुरोधों में यह जानकारी होनी चाहिए: "country": ग्राहक का ISO 3166-1 देश कोड, जैसे कि "US". "firstName": ग्राहक का नाम (ज़्यादा से ज़्यादा 60 वर्ण). "lastName": ग्राहक का उपनाम (ज़्यादा से ज़्यादा 60 वर्ण). "service": "KME" ही एक ऐसी वैल्यू है जो काम करती है.

CreateCustomerResponse

प्रॉपर्टी का नाम	मान	ब्यौरा
customer	object(Company)	नए ग्राहक की जानकारी वाला ऑब्जेक्ट.
vendor_params	map	अतिरिक्त फ़ील्ड, वेंडर की ओर से तय किया गया की-वैल्यू पेयर (सिर्फ़ Samsung के लिए).

गड़बड़ी का व्यवहार

अगर कोई गड़बड़ी होती है, तो लाइब्रेरी CommonException दिखाती है. इसमें गड़बड़ी का इनमें से कोई एक कोड होता है:

CommonException

गड़बड़ी का कोड
INTERNAL_SERVER_ERROR