Method: customers.devices.unclaim
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يلغي العميل المطالبة بملكية جهاز ويزيله من "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".
بعد إزالة جهاز، على العميل التواصل مع المورّد لإعادة تسجيله في برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة".
طلب HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=customers/*}/devices:unclaim
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. العميل الذي يدير الجهاز. اسم مورد واجهة برمجة التطبيقات بالتنسيق customers/[CUSTOMER_ID].
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| الحقول |
device |
object (DeviceReference)
مطلوب. الجهاز المطلوب إلغاء المطالبة به.
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidworkzerotouchemm
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
