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를 캡슐화하여 제조업체의 기기를 식별합니다.
삼성 기기에는 다음 필드 중 하나가 필요합니다.
IMEIserialNumbermeid
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 |
요청 방법을 서버에서 지원하지 않습니다. |