Method: customers.devices.unclaim
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Hebt die Inhaberschaft für ein Gerät für einen Kunden auf und entfernt es aus der Zero-Touch-Registrierung.
Nachdem ein Gerät entfernt wurde, muss der Kunde seinen Reseller kontaktieren, um das Gerät wieder für die Zero-Touch-Registrierung zu registrieren.
HTTP-Anfrage
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:unclaim
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Der Kunde, der das Gerät verwaltet. Ein API-Ressourcenname im Format customers/[CUSTOMER_ID].
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
| Felder |
device |
object (DeviceReference)
Erforderlich. Das Gerät, dessen Beanspruchung aufgehoben werden soll.
|
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/androidworkzerotouchemm
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
