회사 참조
회사를 고유하게 식별합니다.
필드 이름 | 데이터 유형 | 설명 |
---|---|---|
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 |
서버에서 요청 방법을 지원하지 않습니다. |