Method: customers.configurations.delete
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يؤدي هذا الإجراء إلى حذف إعدادات غير مستخدَمة. يتعذّر طلب بيانات من واجهة برمجة التطبيقات إذا كان العميل لديه أجهزة تم تطبيق الإعدادات عليها.
طلب HTTP
DELETE https://androiddeviceprovisioning.googleapis.com/v1/{name=customers/*/configurations/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. الإعداد المطلوب حذفه. اسم مورد واجهة برمجة التطبيقات بالتنسيق customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. إذا تم تطبيق الإعداد على أي أجهزة، سيتعذّر طلب البيانات من واجهة برمجة التطبيقات.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يجب توفير نطاق 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 API endpoint is used to delete an unused configuration using a DELETE HTTP request.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e path parameter is required, which specifies the configuration to delete in the format \u003ccode\u003ecustomers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body for this operation must be empty.\u003c/p\u003e\n"],["\u003cp\u003eIf successful, the response body will also be empty, and it fails if the configuration is applied to any devices.\u003c/p\u003e\n"],["\u003cp\u003eThe authorization scope required for this operation is \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkzerotouchemm\u003c/code\u003e.\u003c/p\u003e\n"]]],["This describes how to delete a configuration using a `DELETE` HTTP request to a specific URL: `https://androiddeviceprovisioning.googleapis.com/v1/{name=customers/*/configurations/*}`. The `name` path parameter, formatted as `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`, is required. The request body must be empty. A successful request returns an empty response body. The API call will fail if devices are using the targeted configuration, and requires the `https://www.googleapis.com/auth/androidworkzerotouchemm` authorization scope.\n"],null,["# Method: customers.configurations.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nDeletes an unused configuration. The API call fails if the customer has devices with the configuration applied.\n\n### HTTP request\n\n`DELETE https://androiddeviceprovisioning.googleapis.com/v1/{name=customers/*/configurations/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The configuration to delete. An API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. If the configuration is applied to any devices, the API call fails. |\n\n### Request body\n\nThe request body must be empty.\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)."]]
