Method: customers.devices.unclaim
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Reprend un appareil à un client et le supprime de l'enregistrement sans contact.
Après avoir supprimé un appareil, le client doit contacter son revendeur pour réenregistrer l'appareil dans l'enregistrement sans contact.
Requête HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:unclaim
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
parent |
string
Obligatoire. Client qui gère l'appareil. Un nom de ressource d'API au format customers/[CUSTOMER_ID].
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Champs |
device |
object (DeviceReference)
Obligatoire. Appareil dont la revendication est annulée.
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse est vide.
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/androidworkzerotouchemm
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
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/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eThis endpoint unclaims a device from a customer, removing it from zero-touch enrollment, requiring the customer to re-register through their reseller if needed.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request method is a \u003ccode\u003ePOST\u003c/code\u003e request to a specific URL using gRPC Transcoding syntax, with the customer ID being a required path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body is required and must contain an object specifying the \u003ccode\u003edevice\u003c/code\u003e to unclaim, referenced by the DeviceReference resource.\u003c/p\u003e\n"],["\u003cp\u003eThe response body will be empty if the request is successful.\u003c/p\u003e\n"],["\u003cp\u003eThis API call requires OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkzerotouchemm\u003c/code\u003e for authorization.\u003c/p\u003e\n"]]],["This document details how to unclaim a device from a customer using the Android zero-touch enrollment API. The key action is sending a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:unclaim`, where `parent` is the customer ID. The request body requires a `device` object specifying the device to unclaim. Successful unclaiming results in an empty response body. Authorization requires the `https://www.googleapis.com/auth/androidworkzerotouchemm` OAuth scope. Unclaiming removes the device from zero-touch enrollment, requiring the customer to re-register it with their reseller.\n"],null,["# Method: customers.devices.unclaim\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nUnclaims a device from a customer and removes it from zero-touch enrollment.\n\nAfter removing a device, a customer must contact their reseller to register the device into zero-touch enrollment again.\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:unclaim`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The customer managing the device. An API resource name in the format `customers/[CUSTOMER_ID]`. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------|---|\n| ``` { \"device\": { object (/zero-touch/reference/customer/rest/v1/DeviceReference) } } ``` |\n\n| Fields ||\n|----------|-------------------------------------------------------------------------------------------------------------------------|\n| `device` | `object (`[DeviceReference](/zero-touch/reference/customer/rest/v1/DeviceReference)`)` Required. The device to unclaim. |\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkzerotouchemm`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
