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 |