إنشاء عميل

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

CreateCustomerResponse

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

سلوك الخطأ

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

CommonException

رمز الخطأ
INTERNAL_SERVER_ERROR