Method: spaces.delete
لحذف مساحة مُعنوَنة تُجري هذه العملية دائمًا عملية حذف متسلسلة، ما يعني أنّه يتم أيضًا حذف الموارد الفرعية للمساحة، مثل الرسائل المنشورة في المساحة وعضويات المساحة. على سبيل المثال، يمكنك الاطّلاع على حذف مساحة.
تتوافق مع أنواع المصادقة التالية:
معاينة المطوّر: مصادقة التطبيق من خلال موافقة المشرف يتطلب ذلك أن يكون تطبيق Chat قد أنشأ المساحة باستخدام مصادقة التطبيق.
مصادقة المستخدم: يمكنك مصادقة هذه الطريقة وتفويضها باستخدام امتيازات المشرف من خلال ضبط الحقل useAdminAccess في الطلب.
طلب HTTP
DELETE https://chat.googleapis.com/v1/{name=spaces/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
name |
string
مطلوب. اسم المورد للمساحة المطلوب حذفها التنسيق: spaces/{space}
|
مَعلمات طلب البحث
| المعلمات |
useAdminAccess |
boolean
اختياريّ. عند true، يتم تنفيذ الطريقة باستخدام امتيازات مشرف Google Workspace الخاصة بالمستخدم. يجب أن يكون المستخدم المتصل مشرفًا في Google Workspace لديه امتياز إدارة المحادثات في Chat وفي "المساحات". تتطلّب هذه الوظيفة chat.admin.delete نطاق OAuth 2.0.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة هو عنصر JSON فارغ.
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/chat.app.deletehttps://www.googleapis.com/auth/chat.admin.deletehttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.delete
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-13 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-13 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This request permanently deletes a space and all its child resources, including messages and memberships."],["Authentication can be performed using app authentication (with administrator approval) or user authentication (including with administrator privileges using `useAdminAccess`)."],["The request requires the space's resource name in the URL path and can optionally use the `useAdminAccess` query parameter for administrator privileges."],["Requires specific OAuth scopes for authorization, such as `chat.app.delete` or `chat.admin.delete`, as detailed in the Authorization guide."]]],["This describes how to delete a named space using the Chat API, including its child resources. A `DELETE` request is sent to `https://chat.googleapis.com/v1/{name=spaces/*}`. The `name` path parameter specifies the space to delete. The `useAdminAccess` query parameter enables administrator privileges, which requires the `chat.admin.delete` OAuth scope and specific admin rights. The request body must be empty, and a successful deletion returns an empty JSON object. Authorization requires specific OAuth scopes.\n"]]
