Asynchronous request to claim up to 100,000 devices for one or more customers.
Asynchronous API methods return a result before the processing is complete. They
also help your app (or tool) remain responsive for your users while they wait
for a long-running operation to complete. Your app should call
getOperation
to check the status of the operation periodically.
[null,null,["Last updated 2024-08-07 UTC."],[[["This asynchronous API allows you to claim up to 100,000 devices for one or more customers."],["Each request using the `ResellerService` class supports claiming devices for only one customer; attempting to claim for multiple customers will result in an `INTERNAL_SERVER_ERROR`."],["The asynchronous method `claimDevicesAsync` returns a result before processing is complete, and you must use `getOperation` to periodically check the status."],["The `ClaimDevicesRequest` requires a list of `DeviceClaim` objects, and each `DeviceClaim` must include a `DeviceIdentifier` and `CompanyReference` for the customer."],["Potential error codes include `DEVICE_UPLOAD_COUNT_EXCEEDED`, `DUPLICATE_DEVICES`, `INTERNAL_SERVER_ERROR`, and various `INVALID` errors related to customer, device identifiers, and device information."]]],["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"]]