Method: projects.deployments.delete
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تؤدي هذه الوظيفة إلى حذف عملية النشر التي تحمل الاسم المحدّد.
طلب HTTP
DELETE https://gsuiteaddons.googleapis.com/v1/{name=projects/*/deployments/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
name |
string
مطلوب. اسم المورد الكامل للنشر المطلوب حذفه. مثال: projects/my_project/deployments/my_deployment
يتطلب التفويض الحصول على إذن IAM التالي في المورد المحدّد name :
gsuiteaddons.deployments.delete
|
مَعلمات طلب البحث
المعلمات |
etag |
string
علامة etag لعملية النشر المطلوب حذفها في حال توفّر هذا العنصر، يجب أن يتطابق مع علامة etag الخاصة بالخادم.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة هو عنصر JSON فارغ.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-04-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-04-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis document details how to delete a Google Workspace Add-on deployment using the \u003ccode\u003eDELETE\u003c/code\u003e HTTP request method.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the deployment's name as a path parameter and optionally an etag as a query parameter for concurrency control.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful deletion results in an empty JSON response body, indicating the deployment has been removed.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this operation necessitates the \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scope and the \u003ccode\u003egsuiteaddons.deployments.delete\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty when sending the delete request.\u003c/p\u003e\n"]]],["This document details the process of deleting a deployment using an HTTP DELETE request. The request URL, employing gRPC Transcoding syntax, requires a `name` path parameter, specifying the deployment's full resource name. Optionally, the `etag` query parameter can be used for conditional deletion. The request body must be empty. Successful deletion returns an empty JSON object. This action requires the `gsuiteaddons.deployments.delete` IAM permission and the `https://www.googleapis.com/auth/cloud-platform` OAuth scope.\n"],null,["# Method: projects.deployments.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes the deployment with the given name.\n\n### HTTP request\n\n`DELETE https://gsuiteaddons.googleapis.com/v1/{name=projects/*/deployments/*}`\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 full resource name of the deployment to delete. Example: `projects/my_project/deployments/my_deployment`. Authorization requires the following [IAM](https://cloud.google.com/iam/docs/) permission on the specified resource `name`: - `gsuiteaddons.deployments.delete` |\n\n### Query parameters\n\n| Parameters ||\n|--------|------------------------------------------------------------------------------------------------------|\n| `etag` | `string` The etag of the deployment to delete. If this is provided, it must match the server's etag. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]