하나 이상의 고객에 대해 최대 100,000대의 기기를 소유하겠다는 비동기 요청입니다.
참고: SamsungResellerServiceFactory
에서 만든 ResellerService
클래스는 요청당 고객 한 명의 기기 소유권 주장만 지원합니다. 여러 고객의 기기가 단일 요청에 포함되면 작업이 실패하고 INTERNAL_SERVER_ERROR
이 반환됩니다.
비동기 API 메서드는 처리가 완료되기 전에 결과를 반환합니다. 또한 장기 실행 작업이 완료될 때까지 사용자가 기다리는 동안 앱 (또는 도구)이 사용자에게 응답을 계속 제공하는 데 도움이 됩니다. 앱은 getOperation
를 호출하여 주기적으로 작업 상태를 확인해야 합니다.
메서드 서명
public ClaimDevicesResponse claimDevicesAsync ( ClaimDevicesRequest request );
ClaimDeviceRequest
속성 이름
값
필수
설명
claims
object(DeviceClaim)
목록입니다.
예
고객 대신 청구를 요청할 기기 목록입니다.
DeviceClaim
속성 이름
값
필수
설명
deviceIdentifier
object(
DeviceIdentifier
)
예
기기 식별자
customer
CompanyReference
객체
예
기기가 할당된 고객에 대한 회사 참조입니다.
orderNumber
string
아니요
주문 번호
vendorParams
map
아니요
추가 필드, 공급업체가 지정한 키-값 쌍입니다.
ClaimDeviceResponse
속성 이름
값
설명
operations
Operation
객체 목록
하나 이상의 ClaimDevices
Operation
인스턴스
오류 동작
오류가 발생하면 Operation
객체는 다음 오류 코드 중 하나를 반환합니다.
오류 코드
DEVICE_UPLOAD_COUNT_EXCEEDED
DUPLICATE_DEVICES
INTERNAL_SERVER_ERROR
INVALID_CUSTOMER_ID
INVALID_DEVICE_IMEI
INVALID_DEVICE_MEID
INVALID_DEVICE_SERIAL
INVALID_IDENTIFIER_SET
INVALID_MANUFACTURER
INVALID_MODEL