يوضّح هذا الدليل طريقة استخدام طريقة get
على مورد membership
في Google Chat API للحصول على تفاصيل حول اشتراك مستخدم أو
تطبيق في Chat في مساحة.
يوضّح
المرجع Membership
ما إذا تمت دعوة مستخدم أو تطبيق Google Chat
إلى مساحة أو جزء منها أو عدم زيارته.
تؤدي المصادقة باستخدام مصادقة التطبيقات إلى السماح لتطبيق Chat بالحصول على الاشتراكات من المساحات التي يمكنه الوصول إليها في Google Chat (مثل المساحات التي يكون عضوًا فيها)، ولكن باستثناء الاشتراكات في تطبيقات Chat، بما في ذلك المساحات الخاصة به. تؤدي المصادقة باستخدام مصادقة المستخدم إلى عرض العضويات من المساحات التي يمكن للمستخدم الذي تمت مصادقتها الوصول إليها.
المتطلبات الأساسية
Python
- Python 3.6 أو أحدث
- تتيح لك أداة إدارة الحِزم pip
أحدث مكتبات عملاء Google للغة Python. لتثبيتها أو تحديثها، شغّل الأمر التالي في واجهة سطر الأوامر:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- مشروع على Google Cloud تم فيه تفعيل Google Chat API وضبطه لمعرفة الخطوات، يُرجى الاطّلاع على مقالة إنشاء تطبيق Google Chat.
تم ضبط التفويض لتطبيق Chat. يتيح الحصول على عضوية كل من طريقتَي المصادقة التاليتَين:
- مصادقة المستخدم
باستخدام نطاق التفويض
chat.memberships.readonly
أوchat.memberships
. - مصادقة التطبيقات
باستخدام نطاق التفويض
chat.bot
.
- مصادقة المستخدم
باستخدام نطاق التفويض
الحصول على تفاصيل حول اشتراك مستخدم أو تطبيق في Chat
للحصول على تفاصيل حول الاشتراك في Google Chat، يُرجى تقديم ما يلي في الطلب:
- باستخدام
مصادقة التطبيق،
حدِّد نطاق التفويض
chat.bot
. باستخدام مصادقة المستخدم، حدِّد نطاق التفويضchat.memberships.readonly
أوchat.memberships
. من بين أفضل الممارسات، اختر النطاق الأكثر تقييدًا الذي يسمح لتطبيقك بالعمل. - استدعِ
طريقة
get
في الموردmembership
. - انقر على
name
للعضوية للاستفادة من هذه الميزة. احصل على اسم الاشتراك من مورد الاشتراك في Google Chat.
إليك كيفية الاشتراك باستخدام مصادقة المستخدم:
Python
- في دليل العمل، أنشِئ ملفًا باسم
chat_membership_get.py
. ضمِّن الرمز التالي في
chat_membership_get.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.readonly"] def main(): ''' Authenticates with Chat API via user credentials, then gets details about a 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().get( # The membership to get. # # 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. name='spaces/SPACE/members/MEMBER' ).execute() # Prints details about the membership. print(result) if __name__ == '__main__': main()
في التعليمة البرمجية، استبدل ما يلي:
SPACE
: اسم مساحة يمكنك الحصول عليه من خلال طريقةspaces.list
في Chat API أو من عنوان URL الخاص بالمساحةMEMBER
: اسم اشتراك يمكنك الحصول عليه من طريقةspaces.members.list
في Chat API.
في دليل العمل، أنشئ النموذج وقم بتشغيله:
python3 chat_membership_get.py
تعرِض Chat API مثيلاً من membership
يوضِّح تفاصيل الاشتراك المحدّد.
مواضيع ذات صلة
- إدراج الأعضاء في مساحة.
- دعوة مستخدم أو تطبيق في Chat أو إضافتهما إلى مساحة
- تعديل اشتراك المستخدم في مساحة Google Chat
- إزالة مستخدم أو تطبيق Chat من مساحة