Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Yêu cầu không đồng bộ để xác nhận quyền sở hữu tối đa 100.000 thiết bị cho một hoặc nhiều khách hàng.
Các phương thức API không đồng bộ trả về kết quả trước khi quá trình xử lý hoàn tất. Các API này cũng giúp ứng dụng (hoặc công cụ) của bạn duy trì khả năng phản hồi của người dùng trong khi họ chờ một thao tác chạy trong thời gian dài hoàn tất. Ứng dụng của bạn phải gọi getOperation để kiểm tra trạng thái của thao tác theo định kỳ.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis asynchronous API allows you to claim up to 100,000 devices for one or more customers.\u003c/p\u003e\n"],["\u003cp\u003eEach request using the \u003ccode\u003eResellerService\u003c/code\u003e class supports claiming devices for only one customer; attempting to claim for multiple customers will result in an \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe asynchronous method \u003ccode\u003eclaimDevicesAsync\u003c/code\u003e returns a result before processing is complete, and you must use \u003ccode\u003egetOperation\u003c/code\u003e to periodically check the status.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eClaimDevicesRequest\u003c/code\u003e requires a list of \u003ccode\u003eDeviceClaim\u003c/code\u003e objects, and each \u003ccode\u003eDeviceClaim\u003c/code\u003e must include a \u003ccode\u003eDeviceIdentifier\u003c/code\u003e and \u003ccode\u003eCompanyReference\u003c/code\u003e for the customer.\u003c/p\u003e\n"],["\u003cp\u003ePotential error codes include \u003ccode\u003eDEVICE_UPLOAD_COUNT_EXCEEDED\u003c/code\u003e, \u003ccode\u003eDUPLICATE_DEVICES\u003c/code\u003e, \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e, and various \u003ccode\u003eINVALID\u003c/code\u003e errors related to customer, device identifiers, and device information.\u003c/p\u003e\n"]]],["The `claimDevicesAsync` method initiates an asynchronous request to claim up to 100,000 devices. Each request, using `ClaimDevicesRequest`, must specify a list of `DeviceClaim` objects, each detailing device identifiers and a customer. The `ResellerService` only supports one customer per request. The method returns `ClaimDevicesResponse` with `Operation` objects for tracking status. Errors, like `DEVICE_UPLOAD_COUNT_EXCEEDED` or `INTERNAL_SERVER_ERROR`, are reported within the `Operation` object.\n"],null,["Asynchronous request to claim up to 100,000 devices for one or more customers.\n| **Note:** The `ResellerService` class created by `SamsungResellerServiceFactory` only supports claiming devices for one customer per request. If devices for multiple customers are put into a single request, the operation will fail and return `INTERNAL_SERVER_ERROR`.\n\nAsynchronous API methods return a result before the processing is complete. They\nalso help your app (or tool) remain responsive for your users while they wait\nfor a long-running operation to complete. Your app should call\n[`getOperation`](/zero-touch/reseller-library/reference/methods/getoperation)\nto check the status of the operation periodically.\n\nMethod signature \n\n public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);\n\nClaimDeviceRequest\n\n| Property name | Value | Required | Description |\n|---------------|-------------------------------|----------|--------------------------------------------------|\n| `claims` | List of `object(DeviceClaim)` | Yes | List of device claims to claim for the customer. |\n\nDeviceClaim\n\n| Property name | Value | Required | Description |\n|--------------------|-----------------------------------------------------|----------|--------------------------------------------------------------------|\n| `deviceIdentifier` | `object(`[`DeviceIdentifier`](#deviceidentifier)`)` | Yes | Device identifier. |\n| `customer` | `CompanyReference` object | Yes | Company reference for the customer that the device is assigned to. |\n| `orderNumber` | `string` | No | Order number. |\n| `vendorParams` | `map` | No | Extra fields, vendor specified key-value pair. |\n\nClaimDeviceResponse\n\n| Property name | Value | Description |\n|---------------|-----------------------------|---------------------------------------------------|\n| `operations` | List of `Operation` objects | One or more `ClaimDevices` `Operation` instances. |\n\nError behavior\n\nIf an error occurs, the `Operation` object returns one of the following error\ncodes:\n\n| Error code |\n|--------------------------------|\n| `DEVICE_UPLOAD_COUNT_EXCEEDED` |\n| `DUPLICATE_DEVICES` |\n| `INTERNAL_SERVER_ERROR` |\n| `INVALID_CUSTOMER_ID` |\n| `INVALID_DEVICE_IMEI` |\n| `INVALID_DEVICE_MEID` |\n| `INVALID_DEVICE_SERIAL` |\n| `INVALID_IDENTIFIER_SET` |\n| `INVALID_MANUFACTURER` |\n| `INVALID_MODEL` |"]]
