إنشاء عميل

إنشاء 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