إنشاء عميل

إنشاء Company عنصر لتحديد الشركة (العميل) بشكل فريد في Knox أو برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" التسجيل. بعد إرجاع الطريقة بنجاح، يتم منح المالكون المحدّدين (primary_emails) أو يمكن للمشرفين (secondary_emails) ربط عناوين البريد الإلكتروني التابعة لهم بحساب حساب للوصول إلى بوابة برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" (لمعرفة التفاصيل، يُرجى الاطّلاع على إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة لمشرفي تكنولوجيا المعلومات) أو حساب Samsung للدخول إلى بوابة Knox Mobile Registry (KME).

توقيع الطريقة

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 ما يلي: "البلد": رمز البلد ISO 3166-1 الخاص بالعميل، على سبيل المثال "US". "firstName": الاسم الأول للعميل (60 حرفًا كحدّ أقصى). "lastName": اسم العائلة للعميل (60 حرفًا كحدّ أقصى). "service": "KME" هي القيمة الوحيدة المدعومة.

CreateCustomerResponse

اسم الموقع	القيمة	الوصف
customer	object(Company)	عنصر يحتوي على تفاصيل العميل الذي تم إنشاؤه حديثًا
vendor_params	map	الحقول الإضافية، يحدد المورِّد زوج المفتاح/القيمة (Samsung فقط).

سلوك الخطأ

في حال حدوث خطأ، ستعرض المكتبة رمز CommonException يحتوي على أحد رموز الخطأ التالية:

CommonException

رمز الخطأ
INTERNAL_SERVER_ERROR