고객 만들기

Knox 또는 제로 터치 등록을 위해 회사 (고객)를 고유하게 식별하는 Company 객체를 만듭니다. 메서드가 성공적으로 반환되면 지정된 소유자 (primary_emails) 또는 관리자 (secondary_emails)가 이메일 주소를 Google 계정과 연결하여 제로터치 고객 포털(자세한 내용은 IT 관리자를 위한 제로터치 등록 참고)에 액세스하거나 삼성 계정과 연결하여 Knox 모바일 등록 (KME) 포털에 액세스할 수 있습니다.

메서드 서명

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

CreateCustomerRequest

속성 이름	값	필수	설명
customer_name	string	예	회사 이름입니다. 예를 들어 XYZ Corp. 은 제로터치 등록 포털에서 회사 직원에게 표시됩니다.
primary_emails	object(string) 목록입니다.	예	제로터치: 소유자 역할의 고객 사용자 이메일 주소입니다. 이메일 주소는 한 개 이상 필요합니다. 각 이메일 주소는 Google 계정과 연결되어 있어야 합니다. 소유자는 관리자와 동일한 액세스 권한을 공유하지만 조직의 포털 사용자를 추가, 삭제, 수정할 수도 있습니다. Samsung: 고객의 최고 관리자의 이메일 주소입니다. 삼성은 목록의 첫 번째 이메일만 사용합니다. 이메일 주소가 삼성 계정과 연결되어 있어야 합니다.
secondary_emails	object(string) 목록입니다.	아니요	관리자 역할의 고객 사용자 이메일 주소입니다. 각 이메일 주소는 Google 계정과 연결되어 있어야 합니다. 참고: 이 속성은 삼성에서 지원하지 않습니다.
vendorParams	map	제로터치: 아니요 삼성: 예	추가 필드, 공급업체가 지정한 키-값 쌍입니다. SamsungResellerService 클래스의 요청은 다음을 지정해야 합니다. 'country': 고객의 ISO 3166-1 국가 코드입니다(예: 'US'). 'firstName': 고객의 이름입니다(최대 60자(영문 기준)). 'lastName': 고객의 성입니다(최대 60자(영문 기준)). 'service': 'KME'만 지원되는 값입니다.

CreateCustomerResponse

속성 이름	값	설명
customer	object(Company)	새로 생성된 고객의 세부정보가 포함된 객체입니다.
vendor_params	map	추가 필드, 공급업체 지정 키-값 쌍 (삼성만 해당)

오류 동작

오류가 발생하면 라이브러리는 다음 오류 코드 중 하나가 포함된 CommonException를 발생시킵니다.

CommonException

오류 코드
INTERNAL_SERVER_ERROR