إنشاء عميل

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

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

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

إنشاء عميل

اسم الموقع	القيمة	مطلوب	الوصف
customer_name	string	نعم	اسم الشركة. على سبيل المثال، يتم عرض شركة XYZ Corp. لموظفي الشركة في بوابة "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة".
primary_emails	تمثّل هذه السمة قائمة object(string).	نعم	إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة: عنوان البريد الإلكتروني لمستخدمي العملاء في دور المالك. يجب إدخال عنوان بريد إلكتروني واحد على الأقل. يجب إقران كل عنوان بريد إلكتروني بحساب Google. يتشارك المالكون حق الوصول نفسه مع المشرفين، ولكن يمكنهم أيضًا إضافة المستخدمين إلى مدخل مؤسستك وحذفهم وتعديلهم. Samsung: عنوان البريد الإلكتروني للمشرف المتميز للعميل. سَتَتِمّْ عَرْضْ رِسَالَةْ بَرِيدْ إِلِكْتْرُونِي الْأَوَّلْ فِي الْقَائِمَة فَقَطْ. يجب إقران عنوان البريد الإلكتروني بحساب Samsung.
secondary_emails	تمثّل هذه السمة قائمة object(string).	لا	عنوان البريد الإلكتروني لمستخدمي العميل في دور المشرف. يجب إقران كل عنوان بريد إلكتروني بحساب Google. ملاحظة: لا تدعم Samsung هذه الخاصية.
vendorParams	map	إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة: لا Samsung: نعم	حقول إضافية، حدد المورّد زوج المفتاح/القيمة. يجب أن تحدّد الطلبات من فئة SamsungResellerService ما يلي: "البلد": رمز البلد ISO 3166-1 للعميل، على سبيل المثال "US". "firstName": الاسم الأول للعميل (60 حرفًا كحدٍ أقصى). "اسم العائلة": الاسم الأخير للعميل (60 حرفًا كحدٍ أقصى). "الخدمة": "KME" هي القيمة المتاحة الوحيدة.

إنشاء رد عميل

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

سلوك الخطأ

إذا حدث خطأ، تعرض المكتبة CommonException التي تتضمن أحد رموز الخطأ التالية:

CommonException

رمز الخطأ
INTERNAL_SERVER_ERROR