ایجاد مشتری

یک شی Company برای شناسایی منحصر به فرد یک شرکت (مشتری) برای ثبت نام Knox یا zero-touch ایجاد می کند. پس از بازگشت موفقیت آمیز روش، مالکان مشخص شده ( primary_emails ) یا سرپرستان ( secondary_emails ) می توانند آدرس ایمیل خود را با یک حساب Google مرتبط کنند تا به پورتال لمسی صفر دسترسی داشته باشند (برای جزئیات، به ثبت نام Zero-touch برای سرپرستان فناوری اطلاعات مراجعه کنید) یا یک حساب Samsung به به پورتال Knox Mobile Enrollment (KME) دسترسی داشته باشید.

امضای روش

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

CreateCustomerRequest

نام ملک	ارزش	مورد نیاز	توضیحات
customer_name	string	بله	نام شرکت. به عنوان مثال XYZ Corp. در پورتال ثبت نام بدون لمس برای کارمندان شرکت نمایش داده می شود.
primary_emails	فهرست object(string)	بله	لمس صفر: آدرس ایمیل کاربران مشتری در نقش مالک. حداقل یک آدرس ایمیل مورد نیاز است. هر آدرس ایمیل باید با یک حساب Google مرتبط باشد. مالکان دسترسی مشابهی با مدیران دارند، اما همچنین می توانند کاربران پورتال سازمان شما را اضافه، حذف و ویرایش کنند. سامسونگ: آدرس ایمیل سوپر ادمین مشتری. سامسونگ فقط اولین ایمیل لیست را دریافت می کند. آدرس ایمیل باید با یک حساب سامسونگ مرتبط باشد.
secondary_emails	فهرست object(string)	خیر	آدرس ایمیل کاربران مشتری در نقش ادمین. هر آدرس ایمیل باید با یک حساب Google مرتبط باشد. توجه: این ویژگی توسط سامسونگ پشتیبانی نمی شود.
vendorParams	map	لمس صفر: خیر سامسونگ: بله	فیلدهای اضافی، جفت کلید-مقدار مشخص شده توسط فروشنده. درخواست‌های کلاس SamsungResellerService باید مشخص کنند: "کشور": کد کشور مشتری ISO 3166-1 ، به عنوان مثال "US". "firstName": نام مشتری (حداکثر 60 کاراکتر). "LastName": نام خانوادگی مشتری (حداکثر 60 کاراکتر). "service": "KME" تنها مقدار پشتیبانی شده است.

CreateCustomerResponse

نام ملک	ارزش	توضیحات
customer	object( Company )	شی حاوی جزئیات مشتری تازه ایجاد شده است.
vendor_params	map	فیلدهای اضافی، جفت کلید-مقدار مشخص شده توسط فروشنده (فقط سامسونگ).

رفتار خطا

اگر خطایی رخ دهد، کتابخانه یک CommonException حاوی یکی از کدهای خطای زیر می‌فرستد:

CommonException

کد خطا
INTERNAL_SERVER_ERROR