Tạo đối tượng Company
để nhận dạng duy nhất một công ty (khách hàng) cho quy trình đăng ký Knox hoặc đăng ký không tiếp xúc. Sau khi phương thức trả về thành công, chủ sở hữu (primary_emails
) hoặc quản trị viên (secondary_emails
) được chỉ định có thể liên kết địa chỉ email của họ với một Tài khoản Google để truy cập vào cổng không tiếp xúc (để biết thông tin chi tiết, hãy xem phần Đăng ký không tiếp xúc cho quản trị viên CNTT) hoặc Tài khoản Samsung để truy cập vào cổng Knox Mobile Enrollment (KME).
Chữ ký phương thức
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
Tên tài sản | Giá trị | Bắt buộc | Mô tả |
---|---|---|---|
customer_name |
string |
Có | Tên của công ty. Ví dụ: Công ty XYZ. Hiển thị cho nhân viên của công ty trong cổng đăng ký không tiếp xúc. |
primary_emails |
Danh sách object(string) |
Có | Tự động đăng ký: Địa chỉ email của người dùng của khách hàng trong vai trò chủ sở hữu. Phải nhập ít nhất một địa chỉ email. Mỗi địa chỉ email phải được liên kết với một Tài khoản Google. Chủ sở hữu có quyền truy cập giống như quản trị viên nhưng cũng có thể thêm, xoá và chỉnh sửa người dùng cổng thông tin của tổ chức. Samsung: Địa chỉ email của quản trị viên cấp cao của khách hàng. Samsung chỉ lấy email đầu tiên trong danh sách. Bạn phải liên kết địa chỉ email với một Tài khoản Samsung. |
secondary_emails |
Danh sách object(string) |
Không | Địa chỉ email của người dùng khách hàng có vai trò quản trị. Mỗi địa chỉ email phải được liên kết với một Tài khoản Google. Lưu ý: Samsung không hỗ trợ thuộc tính này. |
vendorParams |
map |
Thiết lập tự động: Không Samsung: Có |
Các trường bổ sung, cặp khoá-giá trị do nhà cung cấp chỉ định. Các yêu cầu từ lớp SamsungResellerService phải chỉ định:"country": Mã quốc gia ISO 3166-1 của khách hàng, ví dụ: "US". "firstName": tên của khách hàng (tối đa 60 ký tự). "lastName": họ của khách hàng (tối đa 60 ký tự). "service": "KME" là giá trị duy nhất được hỗ trợ. |
CreateCustomerResponse
Tên tài sản | Giá trị | Mô tả |
---|---|---|
customer |
object( Company ) |
Đối tượng chứa thông tin chi tiết về khách hàng mới tạo. |
vendor_params |
map |
Các trường bổ sung, cặp khoá-giá trị do nhà cung cấp chỉ định (chỉ dành cho Samsung). |
Hành vi lỗi
Nếu xảy ra lỗi, thư viện sẽ gửi một CommonException
chứa một trong các mã lỗi sau:
CommonException
Mã lỗi |
---|
INTERNAL_SERVER_ERROR |