객체

회사 참조

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

필드 이름 데이터 유형 설명
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 호출의 상태가 포함됩니다. 네 가지 가능한 상태가 있습니다.

  • 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 공급업체에서 지정한 키-값 쌍의 추가 필드

기기 작업 오류

Operation의 기기별 오류입니다. 각 리소스에는 작업을 시작한 요청과 동일한 deviceId 및 deviceIdentifier가 포함되어 있습니다.

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

일반 예외

모든 동기 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 입력한 customerId가 잘못되었습니다.
INVALID_DEVICE_IMEI 잘못된 IMEI입니다.
INVALID_DEVICE_MEID MEID가 잘못되었습니다.
INVALID_DEVICE_SERIAL 일련번호가 잘못되었습니다.
INVALID_OPERATION_ID 입력한 운영 ID가 잘못되었습니다.
INVALID_RESELLER_ID 입력한 ResellerId가 잘못되었습니다.
INVALID_MANUFACTURER 제공된 제조업체가 잘못되거나 지원되지 않습니다.
INVALID_IDENTIFIER_SET 제공된 식별자 세트는 요청에 충분하지 않습니다. 허용되는 식별자 세트에 관한 자세한 내용은 DeviceIdentifier를 참고하세요.
INVALID_MODEL 제공된 모델이 잘못되었거나 지원되지 않습니다.
INVALID_DEVICE_ID 제공된 deviceId가 잘못되었습니다.
INVALID_DEVICE 입력한 기기가 존재하지 않습니다. 삼성 관련 오류 코드입니다.
DUPLICATE_DEVICE 이전에 같은 고객에 대해 기기 보증을 받았습니다. 시정 조치가 필요하지 않습니다.
DEVICE_UPLOAD_COUNT_EXCEEDED 요청에 한도 (현재 100k)가 넘는 기기가 포함되어 있습니다.
AUTHORIZATION_FAIL 지정된 리소스 (예: 기기, 고객)에 대한 액세스 권한이 없거나 리소스가 존재하지 않습니다. vendorMsg에서 자세한 내용을 확인하세요.
INTERNAL_SERVER_ERROR 지정되지 않은 내부 서버 오류입니다. 자세한 내용은 vendorMsg에서 확인하세요. 이러한 요청은 서버 오류의 특성에 따라 재시도할 수 있습니다.
NOT_IMPLEMENTED 서버에서 요청 방법을 지원하지 않습니다.