สร้างลูกค้า

สร้าง Company ระบุบริษัท (ลูกค้า) ที่ไม่ซ้ำกันสำหรับ Knox หรือการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม การลงทะเบียนเข้าร่วม หลังจากเมธอดส่งคืนสำเร็จ เจ้าของที่ระบุ (primary_emails) หรือผู้ดูแลระบบ (secondary_emails) สามารถเชื่อมโยงอีเมลของตนกับบัญชี บัญชีสำหรับเข้าถึงพอร์ทัล Zero Touch (โปรดดูรายละเอียดที่หัวข้อการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มสำหรับผู้ดูแลระบบไอที) หรือบัญชี Samsung เพื่อเข้าถึงพอร์ทัล Knox Mobile Registration (KME) ได้

ลายเซ็นเมธอด

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

CreateCustomerRequest

ชื่อพร็อพเพอร์ตี้ ค่า ต้องระบุ คำอธิบาย
customer_name string ใช่ ชื่อบริษัท เช่น XYZ Corp. ที่แสดงแก่พนักงานของบริษัทในพอร์ทัลการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม
primary_emails รายการ object(string) ใช่ การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม: อีเมลของผู้ใช้ในบทบาทเจ้าของ ต้องป้อนอีเมลอย่างน้อย 1 รายการ อีเมลแต่ละรายการต้องเชื่อมโยงกับบัญชี Google เจ้าของจะมีสิทธิ์การเข้าถึงเดียวกับผู้ดูแลระบบ แต่จะเพิ่ม ลบ และแก้ไขผู้ใช้พอร์ทัลขององค์กรได้

Samsung: อีเมลของผู้ดูแลระบบขั้นสูงของลูกค้า Samsung จะใช้เฉพาะอีเมลแรกในรายการเท่านั้น ที่อยู่อีเมลจะต้องเชื่อมโยงกับบัญชี Samsung
secondary_emails รายการ object(string) ไม่ได้ อีเมลของผู้ใช้ในบทบาทผู้ดูแลระบบของลูกค้า อีเมลแต่ละรายการต้องเชื่อมโยงกับบัญชี Google หมายเหตุ: Samsung ไม่รองรับพร็อพเพอร์ตี้นี้
vendorParams map การตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่ม: ไม่

Samsung: ใช่
ฟิลด์เพิ่มเติม คู่คีย์-ค่าที่ระบุโดยผู้ให้บริการ คำขอจากคลาส SamsungResellerService ต้องระบุ:

"ประเทศ": รหัสประเทศ ISO 3166-1 ของลูกค้า เช่น "US"

"firstName": ชื่อของลูกค้า (สูงสุด 60 อักขระ)

"lastName": นามสกุลของลูกค้า (สูงสุด 60 อักขระ)

"service": "KME" เป็นค่าเดียวที่รองรับ

CreateCustomerResponse

ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย
customer object(Company) ออบเจ็กต์ที่มีรายละเอียดของลูกค้าที่สร้างใหม่
vendor_params map ช่องเพิ่มเติม คู่คีย์-ค่าที่ผู้ให้บริการระบุ (Samsung เท่านั้น)

ลักษณะการทำงานของข้อผิดพลาด

หากเกิดข้อผิดพลาด ไลบรารีจะส่ง CommonException ที่มี รหัสข้อผิดพลาดต่อไปนี้:

CommonException

รหัสข้อผิดพลาด
INTERNAL_SERVER_ERROR