Référence de l'entreprise du client auquel l'appareil est attribué.
orderNumber
string
Non
Numéro de la commande
vendorParams
map
Non
Champs supplémentaires, paire clé-valeur spécifiée par le fournisseur.
ClaimDeviceResponse
Nom de propriété
Valeur
Description
deviceId
string
ID de l'appareil, précédé du préfixe "samsung/" ou "google/".
Comportement en cas d'erreur
Si une erreur se produit, la bibliothèque génère une CommonException contenant l'un des codes d'erreur suivants:
Code d'erreur
AUTHORIZATION_FAIL
DUPLICATE_DEVICES
INVALID_CUSTOMER_ID
INVALID_DEVICE_IMEI
INVALID_DEVICE_MEID
INVALID_DEVICE_SERIAL
INVALID_IDENTIFIER_SET
INVALID_MANUFACTURER
INVALID_MODEL
NOT_IMPLEMENTED
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eThis API allows a synchronous request to claim a single device for a specific customer, utilizing the \u003ccode\u003eclaimDevice\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eclaimDevice\u003c/code\u003e method requires a \u003ccode\u003eClaimDeviceRequest\u003c/code\u003e object, which must include a \u003ccode\u003eDeviceClaim\u003c/code\u003e object containing the device identifier and customer details.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eDeviceClaim\u003c/code\u003e object necessitates a \u003ccode\u003eDeviceIdentifier\u003c/code\u003e and a \u003ccode\u003eCompanyReference\u003c/code\u003e object, optionally accepting an order number and vendor-specific parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eclaimDevice\u003c/code\u003e method returns a \u003ccode\u003eClaimDeviceResponse\u003c/code\u003e containing the device ID, prefixed with either 'samsung/' or 'google/'.\u003c/p\u003e\n"],["\u003cp\u003eThe API can throw a \u003ccode\u003eCommonException\u003c/code\u003e with various error codes, including \u003ccode\u003eAUTHORIZATION_FAIL\u003c/code\u003e, \u003ccode\u003eDUPLICATE_DEVICES\u003c/code\u003e, and several \u003ccode\u003eINVALID_*\u003c/code\u003e errors, indicating potential issues with the request.\u003c/p\u003e\n"]]],["This describes the `claimDevice` method, which synchronously claims a single device for a customer. It requires a `DeviceClaim` object containing the `deviceIdentifier` and `customer` details. Optional fields include `orderNumber` and `vendorParams`. The method returns a `ClaimDeviceResponse` containing the `deviceId`. Errors are handled by a `CommonException` with codes like `AUTHORIZATION_FAIL`, `INVALID_CUSTOMER_ID`, and `DUPLICATE_DEVICES`. This API is not supported by the `ResellerService` class.\n"],null,["# claimDevice\n\nSynchronous request to claim a single device for a specified customer.\n| **Note:** The `ResellerService` class created by `SamsungResellerServiceFactory` class doesn't support this API. Use [`claimDeviceAsync`](/zero-touch/reseller-library/reference/methods/claimdevicesasync) instead.\n\nMethod signature\n----------------\n\n public ClaimDeviceResponse claimDevice(ClaimDeviceRequest request) throws CommonException;\n\nClaimDeviceRequest\n------------------\n\n| Property name | Value | Required | Description |\n|---------------|----------------------|----------|-----------------------------------|\n| `claim` | `DeviceClaim` object | Yes | The device claim to be processed. |\n\nDeviceClaim\n-----------\n\n| Property name | Value | Required | Description |\n|--------------------|----------------------------------------------------------------------------------------------|----------|--------------------------------------------------------------------|\n| `deviceIdentifier` | `object(`[`DeviceIdentifier`](#deviceidentifier)`)` | Yes | Device identifier. |\n| `customer` | [`CompanyReference`](/zero-touch/reseller-library/reference/objects#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\n| Property name | Value | Description |\n|---------------|----------|-------------------------------------------------------|\n| `deviceId` | `string` | The device ID, prefixed with 'samsung/' or 'google/'. |\n\nError behavior\n--------------\n\nIf an error occurs, the library throws a `CommonException` containing one of the\nfollowing error codes:\n\n| Error code |\n|--------------------------|\n| `AUTHORIZATION_FAIL` |\n| `DUPLICATE_DEVICES` |\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` |\n| `NOT_IMPLEMENTED` |"]]
