يشرح هذا الدليل كيفية استخدام طريقة delete
على مورد Space
الخاص بـ
Google Chat API لحذف مساحة مُعنوَنة عند عدم الحاجة إليها جارٍ حذف
المساحة أيضًا كل ما تحتويه، بما في ذلك الرسائل
المرفقات.
تشير رسالة الأشكال البيانية
مرجع Space
يمثّل مكانًا يمكن فيه للمستخدمين والتطبيقات في Chat إرسال رسائل
ومشاركتها والتعاون. تتوفّر عدة أنواع من المساحات:
- الرسائل المباشرة هي محادثات بين مستخدمين أو مستخدم تطبيق Chat.
- الدردشات الجماعية هي محادثات بين ثلاثة مستخدمين أو أكثر تطبيقات Chat
- المساحات المُعنونة هي أماكن دائمة يرسل من خلالها المستخدمون الرسائل ويشاركون الملفات والتعاون.
المتطلبات الأساسية
Python
- Python 3.6 أو أعلى
- النافذة ضمن النافذة أداة إدارة الحِزم
أحدث مكتبات برامج Google للغة بايثون. لتثبيت التطبيقات أو تحديثها، شغّل الأمر التالي في واجهة سطر الأوامر:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- مشروع على Google Cloud مع تفعيل وإعداد Google Chat API لمعرفة الخطوات، يُرجى الاطّلاع على إنشاء تطبيق Google Chat
تم ضبط التفويض لتطبيق Chat. جارٍ الحذف مساحة تتطلب مصادقة المستخدم باستخدام نطاق تفويض
chat.delete
من مستخدم لديه إذن لحذف المساحة المحددة.
Node.js
- Node.js & عدد النبضات في الدقيقة
أحدث مكتبات برامج Google لنظام Node.js. لتثبيتها، شغّل التالي في واجهة سطر الأوامر:
npm install @google-cloud/local-auth @googleapis/chat
- مشروع على Google Cloud مع تفعيل وإعداد Google Chat API لمعرفة الخطوات، يُرجى الاطّلاع على إنشاء تطبيق Google Chat
تم ضبط التفويض لتطبيق Chat. جارٍ الحذف مساحة تتطلب مصادقة المستخدم باستخدام نطاق تفويض
chat.delete
من مستخدم لديه إذن لحذف المساحة المحددة.
حذف مساحة مُسَمّاة
لحذف مساحة حالية في Google Chat، عليك تمرير ما يلي: في طلبك:
- حدِّد نطاق تفويض
chat.delete
. - عليك استدعاء
طريقة
delete
في مرجعSpace
. - مرِّر سريعًا على
name
من المساحة لحذفها.
في ما يلي كيفية حذف مساحة:
Python
- في دليل العمل، أنشِئ ملفًا باسم "
chat_space_delete.py
". أدرِج الرمز التالي في
chat_space_delete.py
:from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.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.delete"] def main(): ''' Authenticates with Chat API via user credentials, then deletes the specified space. ''' # Authenticate with Google Workspace # and get user authorization. flow = InstalledAppFlow.from_client_secrets_file( 'client_secrets.json', SCOPES) creds = flow.run_local_server() # 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 أو من عنوان URL للمساحة.في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_space_delete.py
Node.js
- في دليل العمل، أنشِئ ملفًا باسم "
delete-space.js
". أدرِج الرمز التالي في
delete-space.js
:const chat = require('@googleapis/chat'); const {authenticate} = require('@google-cloud/local-auth'); /** * Deletes a Chat space. * @return {!Promise<!Object>} */ async function deleteSpace() { const scopes = [ 'https://www.googleapis.com/auth/chat.delete', ]; const authClient = await authenticate({scopes, keyfilePath: 'client_secrets.json'}); const chatClient = await chat.chat({version: 'v1', auth: authClient}); return await chatClient.spaces.delete({name: 'spaces/SPACE'}); } deleteSpace().then(console.log);
في الرمز، استبدِل
SPACE
باسم مساحة التي يمكنك الحصول عليها من طريقة واحدة (spaces.list
) في Chat API أو من عنوان URL للمساحة.في دليل العمل، شغِّل النموذج:
node delete-space.js
في حالة نجاح الاستجابة، يكون نص الاستجابة فارغًا، مما يشير إلى أن المسافة حذف.
مواضيع ذات صلة
- إنشاء مساحة
- الحصول على تفاصيل حول مساحة
- إدراج المساحات:
- تعديل مساحة
- حذف المساحة
- إعداد مساحة
- العثور على مساحة رسائل مباشرة