يشرح هذا الدليل كيفية استخدام طريقة delete
على المرجع membership
.
Google Chat API لإزالة عضو من مساحة تُعرف أيضًا باسم
العضوية. لا يمكن إزالة مدراء المساحات إذا كانوا المدير الوحيد للمساحة.
في مساحة ما. يجب تعيين مستخدم آخر كمدير قبل إزالة هؤلاء المستخدمين
العضوية في القناة.
تشير رسالة الأشكال البيانية
مرجع Membership
يمثِّل ما إذا تمت دعوة مستخدِم أو تطبيق Google 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.memberships
أوchat.memberships.app
من مستخدم الذي لديه الإذن لحذف الاشتراك المحدّد
إزالة عضو من مساحة
لإزالة مستخدم أو "مجموعة Google" أو تطبيق Chat من مساحة:
- لإزالة مستخدم أو "مجموعة Google"، حدِّد تفويض
chat.memberships
. النطاق. لإزالة تطبيق Chat، حدِّدchat.memberships.app
نطاق التفويض (لا يمكن للتطبيقات حذف سوى نطاقها الخاص عضوية وليس للتطبيقات الأخرى). كأفضل ممارسة، اختر الأكثر نطاق مقيَّد لا يزال يسمح لتطبيقك بالعمل. - يمكنك استدعاء طريقة
delete
. في صفحة مرجع واحد (membership
) - عليك اجتياز
name
للعضوية لحذفها. إذا كانت العضوية تعود إلى مدير مساحة فقط في مساحة، عليك تعيين مستخدم آخر كمدير قبل جارٍ حذف هذه العضوية.
إليك كيفية حذف عضوية:
Python
- في دليل العمل، أنشِئ ملفًا باسم "
chat_membership_delete.py
". أدرِج الرمز التالي في
chat_membership_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.memberships.app"] def main(): ''' Authenticates with Chat API via user credentials, then deletes the specified membership. ''' # 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().members().delete( # The membership 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. # # Replace MEMBER with a membership name. # Obtain the membership name from the memberships resource of # Chat API. To delete a Chat app's membership, replace MEMBER # with app; an alias for the app calling the API. name='spaces/SPACE/members/MEMBER' ).execute() # Print Chat API's response in your command line interface. # When deleting a membership, the response body is empty. print(result) if __name__ == '__main__': main()
في الرمز، استبدل ما يلي:
SPACE
: اسم مساحة يمكنك الحصول عليه من طريقةspaces.list
في Chat API أو من عنوان URL للمساحة.MEMBER
: اسم اشتراك يمكنك الحصول عليه من طريقةspaces.members.list
في Chat API لحذف اشتراك في تطبيق، عليك استبدال "MEMBER
" مع "app
"
في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_membership_delete.py
إذا كانت الاستجابة ناجحة، يعرض نص الاستجابة العضوية بـ
'state': 'NOT_A_MEMBER'
، يشير إلى أنّ العضو لم يعد في المساحة.
{ "name": "spaces/SPACE/members/MEMBER", "state": "NOT_A_MEMBER" }
مواضيع ذات صلة
- الحصول على تفاصيل حول عضوية المستخدم أو تطبيق Chat
- قائمة الأعضاء في مساحة
- تعديل عضوية مستخدم في مساحة Google Chat
- دعوة مستخدم أو تطبيق Chat أو إضافة إلى مساحة