يوضّح هذا الدليل كيفية استخدام طريقة
delete()
في مصدر Space ضِمن Google Chat API لحذف مساحة محدّدة الاسم عندما
لا تعود هناك حاجة إليها. يؤدي حذف مساحة إلى حذف كل ما تحتويه، بما في ذلك الرسائل والمرفقات.
إذا كنت مشرف Google Workspace، يمكنك استدعاء طريقة delete() لحذف أي مساحة محدّدة الاسم في مؤسسة Google Workspace.
يمثّل المصدر
Space مكانًا يمكن للمستخدمين وتطبيقات Chat إرسال الرسائل ومشاركة الملفات والتعاون فيه.
هناك عدة أنواع من المساحات:
- الرسائل المباشرة (DMs) هي محادثات بين مستخدمَين أو بين مستخدم وتطبيق Chat.
- المحادثات الجماعية هي محادثات بين ثلاثة مستخدمين أو أكثر وتطبيقات Chat.
- المساحات المحدّدة الاسم هي أماكن دائمة يرسل فيها المستخدمون الرسائل ويشاركون الملفات ويتعاونون.
المتطلبات الأساسية
Node.js
- إعداد بيئتك:
- إنشاء مشروع على Google Cloud.
- ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.
- تفعيل Google Chat API وضبطه باستخدام اسم و رمز ووصف لتطبيق Chat.
- تثبيت مكتبة عملاء Google Cloud لـ Node.js.
-
إنشاء بيانات اعتماد معرّف عميل OAuth لتطبيق على الكمبيوتر المكتبي. لتشغيل النموذج في هذا
الدليل، احفظ بيانات الاعتماد كملف JSON باسم
credentials.jsonفي دليلك المحلي.
- اختيار نطاق تفويض يتيح مصادقة المستخدم
- مساحة في Google Chat لإنشاء مساحة باستخدام Google Chat API، يُرجى الاطّلاع على مقالة إنشاء مساحة. لإنشاء مساحة في Chat، يُرجى الانتقال إلى مستندات مركز المساعدة.
حذف مساحة محدّدة الاسم بصفتك مستخدمًا
لحذف مساحة حالية في Google Chat باستخدام مصادقة المستخدم، مرِّر ما يلي في طلبك:
- حدِّد نطاق التفويض
chat.delete. - استدعِ طريقة
DeleteSpace(). - مرِّر
nameالمساحة المطلوب حذفها.
في ما يلي كيفية حذف مساحة:
Node.js
لتشغيل هذا النموذج، استبدِل SPACE_NAME برقم التعريف من
حقل
name
المساحة. يمكنك الحصول على رقم التعريف من خلال استدعاء الـ
ListSpaces()
طريقة أو من عنوان URL للمساحة.
حذف مساحة محدّدة الاسم بصفتك تطبيق Chat
تتطلب مصادقة التطبيق موافقة المشرف لمرة واحدة .
باستخدام مصادقة التطبيق، لا يمكنك حذف سوى المساحات التي أنشأتها تطبيقات Chat.
لحذف مساحة حالية في Google Chat باستخدام مصادقة التطبيق، مرِّر ما يلي في طلبك:
- حدِّد نطاق التفويض
chat.app.delete. - استدعِ الطريقة
deleteفي المصدرSpace. - مرِّر
nameالمساحة المطلوب حذفها.
كتابة نص برمجي يستدعي Chat API
في ما يلي كيفية حذف مساحة:
Python
- في دليل العمل، أنشئ ملفًا باسم
chat_space_delete_app.py. أدرِج الرمز البرمجي التالي في
chat_space_delete_app.py:from google.oauth2 import service_account from apiclient.discovery import build # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.app.delete"] def main(): ''' Authenticates with Chat API using app authentication, then deletes the specified space. ''' # Specify service account details. creds = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build a service endpoint for Chat API. chat = build('chat', 'v1', credentials=creds) # Use the service endpoint to call Chat API. result = chat.spaces().delete( # The space to delete. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. name='spaces/SPACE' ).execute() # Print Chat API's response in your command line interface. # When deleting a space, the response body is empty. print(result) if __name__ == '__main__': main()في الرمز البرمجي، استبدِل ما يلي:
SPACEباسم المساحة، الذي يمكنك الحصول عليه منspaces.listالطريقة في Chat API أو من عنوان URL لمساحة.
في دليل العمل، أنشئ النموذج و شغِّله:
python3 chat_space_delete_app.py
إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا، ما يشير إلى حذف المساحة.
حذف مساحة محدّدة الاسم بصفتك مشرف Google Workspace
إذا كنت مشرف Google Workspace، يمكنك استدعاء طريقة DeleteSpace() لحذف أي مساحة محدّدة الاسم في مؤسسة Google Workspace.
لاستدعاء هذه الطريقة بصفتك مشرف Google Workspace، اتّبِع الخطوات التالية:
- استدعِ الطريقة باستخدام مصادقة المستخدم، وحدِّد نطاق تفويض يتيح استدعاء الطريقة باستخدام امتيازات المشرف.
- في طلبك، حدِّد مَعلمة طلب البحث
useAdminAccessعلىtrue.
لمزيد من المعلومات والأمثلة، يُرجى الاطّلاع على مقالة إدارة مساحات Google Chat بصفتك مشرف Google Workspace.
مواضيع ذات صلة
- إنشاء مساحة
- الحصول على تفاصيل حول مساحة.
- عرض قائمة بالمساحات.
- تعديل مساحة.
- حذف مساحة.
- إعداد مساحة.
- العثور على مساحة رسالة مباشرة.