إنشاء عميل

لإنشاء عنصر Company لتحديد شركة (عميل) بشكل فريد من أجل تسجيل Knox أو تسجيل بلمسة واحدة. بعد نجاح الطريقة، يمكن للمالكين المحدّدين (primary_emails) أو المشرفين (secondary_emails) ربط عناوين بريدهم الإلكتروني بحساب Google للوصول إلى بوابة عملاء برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" (للاطّلاع على التفاصيل، راجِع إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة لمشرفي تكنولوجيا المعلومات) أو حساب Samsung للوصول إلى بوابة Knox Mobile Enrollment (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 ما يلي: "country": رمز بلد ISO 3166-1 للعميل، على سبيل المثال "US". "firstName": الاسم الأول للعميل (60 حرفًا بحد أقصى). "lastName": اسم العائلة للعميل (60 حرفًا بحد أقصى). "service": "KME" هي القيمة الوحيدة المسموح بها.

CreateCustomerResponse

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

سلوك الخطأ

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

CommonException

رمز الخطأ
INTERNAL_SERVER_ERROR