สร้างลูกค้า

สร้างออบเจ็กต์ Company เพื่อระบุบริษัท (ลูกค้า) ที่ไม่ซ้ำกันสำหรับการลงทะเบียน Knox หรือลงทะเบียนแบบรวมศูนย์ หลังจากวิธีการแสดงผลสําเร็จแล้ว เจ้าของ (primary_emails) หรือผู้ดูแลระบบ (secondary_emails) ที่ระบุจะเชื่อมโยงอีเมลกับบัญชี Google เพื่อเข้าถึงพอร์ทัลอุปกรณ์พร้อมใช้แบบรวมกลุ่มสําหรับลูกค้า (ดูรายละเอียดที่การลงทะเบียนการตั้งค่าอุปกรณ์พร้อมใช้แบบรวมกลุ่มสําหรับผู้ดูแลระบบไอที) หรือบัญชี Samsung เพื่อเข้าถึงพอร์ทัลการลงทะเบียนใช้งาน Knox Mobile (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 ต้องระบุข้อมูลต่อไปนี้

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

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

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

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

CreateCustomerResponse

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

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

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

CommonException

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