إنشاء عميل

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

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

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

CreateCustomerRequest

اسم الموقع القيمة مطلوب الوصف
customer_name string نعم اسم الشركة على سبيل المثال، شركة XYZ. يتم عرضها لموظفي الشركة في منصة إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة.
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