사물

CompanyReference

회사를 고유하게 식별합니다.

필드 이름 데이터 유형 설명
companyId string 출력 전용입니다. 서버에서 할당한 회사의 ID입니다.
vendor enum Samsung 또는 Google.

회사

회사를 나타냅니다.

필드 이름 데이터 유형 설명
companyReference object(CompanyReference) 회사 참조 객체입니다.
companyName string 회사 이름입니다. 예: XYZ Corp. 제로터치 등록 포털에서 회사 직원에게 표시됩니다.
vendorParams map 공급업체가 지정한 키-값 쌍의 추가 필드입니다.

기기

등록에 등록된 Android 기기.

필드 이름 데이터 유형 설명
deviceId string 출력 전용입니다. 서버에서 할당한 기기의 ID입니다.
deviceIdentifier object(DeviceIdentifier) 제조된 기기를 식별하는 하드웨어 ID
customer object(CompanyReference) 기기가 할당된 회사를 식별하는 회사 ID입니다.
orderNumber string 주문 번호입니다.
vendorParams map 공급업체가 지정한 키-값 쌍의 추가 필드입니다.

DeviceIdentifier

하드웨어 및 제품 ID를 캡슐화하여 제조업체의 기기를 식별합니다.

삼성 기기에는 다음 필드 중 하나가 필요합니다.

  • IMEI
  • serialNumber
  • meid

model와 같은 다른 모든 필드는 무시됩니다.

기타 모든 Android 기기:

  • 모바일 기기에는 imei 및 manufacturer가 필요합니다.
  • Wi-Fi 전용 기기에는 serialNumber, manufacturer, model가 필요합니다.
필드 이름 데이터 유형 설명
imei string 기기의 IMEI 번호 입력 시 검증되었습니다.
serialNumber string 기기 제조업체의 일련번호입니다. 이 값은 기기 모델마다 고유하지 않을 수 있습니다.
meid string 기기의 MEID 번호입니다.
manufacturer string 기기 제조업체 이름입니다. android.os.Build.MANUFACTURER에서 반환된 기기의 내장 값과 일치합니다. 허용되는 값은 제조업체에 나와 있습니다.
model string 기기 모델의 이름입니다. android.os.Build.MODEL에서 반환된 기기의 내장 값과 일치합니다. 허용되는 값은 모델에 나열되어 있습니다.

작업

이 리소스에는 비동기 API 호출의 상태가 포함됩니다. 4가지 가능한 상태는 다음과 같습니다.

  • IN_PROGRESS: 작업이 진행 중입니다.
  • COMPLETE: 모든 기기가 성공적으로 처리되었습니다.
  • COMPLETE_WITH_ERRORS: 작업이 처리되었지만 몇 가지 오류가 발생했습니다. 모든 오류는 deviceErrors 목록에 나열됩니다.
  • FAILED: 작업이 실패했으며 operationId이 반환되지 않습니다.
필드 이름 데이터 유형 설명
operationId string samsung/ 또는 google/가 접두사로 지정된 작업 ID입니다. 비어 있으면 state은 FAILED입니다.
operationType enum(operationType) 작업 유형: CLAIM_DEVICES 또는 UNCLAIM_DEVICES
state enum(operationState) 작업 상태는 IN_PROGRESS, COMPLETE, COMPLETE_WITH_ERRORS, FAILED입니다.
deviceErrors object(DeviceOperationError) 목록 기기 작업 오류 목록입니다.
vendorParams map 공급업체가 지정한 키-값 쌍의 추가 필드입니다.

DeviceOperationError

Operation의 기기별 오류입니다. 각 리소스는 작업을 시작한 요청으로서의 deviceId 및 deviceIdentifier

필드 이름 데이터 유형 설명
deviceId string 출력 전용입니다. 서버에서 할당한 기기의 ID입니다.
deviceIdentifier object(DeviceIdentifier) 제조된 기기를 식별하는 하드웨어 ID
error object(Error) 기기 작업 오류입니다.

CommonException

모든 동기 API에서 발생할 수 있는 예외입니다.

속성 이름 값 설명
error object(Error) 동기 작업 오류입니다.

오류

오류에 대한 세부정보가 포함된 객체입니다.

속성 이름 값 설명
code enum(ErrorCode) 오류 코드입니다. 예를 들면 INVALID_REQUESET 또는 PERMISSION_DENIED입니다.
message string 오류 메시지.
vendorMsg string 오류에 대한 공급업체의 자세한 설명
errorId string 내부 오류 식별자입니다.
vendorParams map 공급업체가 지정한 키-값 쌍의 추가 필드입니다.

ErrorCode

일반적인 오류입니다.

열거형 설명
INVALID_PARAM_DEFAULT 지정되지 않은 잘못된 입력 매개변수입니다. 자세한 내용은 vendorMsg를 참고하세요.
INVALID_PAGE_TOKEN 제공된 pageToken이 잘못되었습니다.
INVALID_CUSTOMER_ID 입력한 고객 ID가 잘못되었습니다.
INVALID_DEVICE_IMEI 잘못된 IMEI입니다.
INVALID_DEVICE_MEID 잘못된 MEID입니다.
INVALID_DEVICE_SERIAL 일련번호가 잘못되었습니다.
INVALID_OPERATION_ID 입력한 작업 ID가 잘못되었습니다.
INVALID_RESELLER_ID 입력한 리셀러 ID가 잘못되었습니다.
INVALID_MANUFACTURER 제공된 제조업체가 잘못되었거나 지원되지 않습니다.
INVALID_IDENTIFIER_SET 제공된 식별자 집합이 요청에 충분하지 않습니다. 허용되는 식별자 집합에 관한 자세한 내용은 DeviceIdentifier를 참고하세요.
INVALID_MODEL 제공된 모델이 잘못되었거나 지원되지 않습니다.
INVALID_DEVICE_ID 입력한 deviceId가 잘못되었습니다.
INVALID_DEVICE 제공된 기기가 존재하지 않습니다. 삼성 관련 오류 코드입니다.
DUPLICATE_DEVICE 이전에 동일한 고객에게 기기의 소유권이 주장되었습니다. 시정 조치는 필요하지 않습니다.
DEVICE_UPLOAD_COUNT_EXCEEDED 요청에 한도 (현재 10만 개)보다 많은 기기가 포함되어 있습니다.
AUTHORIZATION_FAIL 지정된 리소스 (예: 기기, 고객)에 대한 액세스 권한이 없거나 리소스가 존재하지 않습니다. vendorMsg에서 자세한 내용을 확인하세요.
INTERNAL_SERVER_ERROR 지정되지 않은 내부 서버 오류입니다. 자세한 내용은 vendorMsg를 참고하세요. 이러한 요청은 서버 오류의 특성에 따라 재시도될 수 있습니다.
NOT_IMPLEMENTED 요청 방법을 서버에서 지원하지 않습니다.