يشرح هذا الدليل كيفية استخدام طريقة get
على المرجع membership
.
Google Chat API للحصول على تفاصيل حول الاشتراك في مساحة
تشير رسالة الأشكال البيانية
مرجع Membership
يمثِّل ما إذا تمت دعوة مستخدِم أو تطبيق Google Chat إلى
أو جزء منها أو غير موجود فيه.
المصادقة مع مصادقة التطبيقات يتيح لتطبيق Chat الحصول على اشتراكات من المساحات التي يتوفر فيها إمكانية الوصول إليها في Google Chat (على سبيل المثال، المساحات المنضم إليها)، ولكن باستثناء الاشتراكات في التطبيقات في Chat، بما في ذلك اشتراكاتها الخاصة جارٍ المصادقة مع مصادقة المستخدم يعرض الاشتراكات من المساحات التي يمكن للمستخدم الذي تمت المصادقة عليه الوصول إليها.
المتطلبات الأساسية
Python
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
- تثبيت بايثون مكتبة برامج Google API
- إنشاء بيانات اعتماد الوصول استنادًا إلى طريقة المصادقة في Google Chat API
الطلب:
- للمصادقة كمستخدم Chat،
إنشاء معرِّف عميل OAuth
بيانات الاعتماد وحفظ بيانات الاعتماد كملف JSON
client_secrets.json
إلى الدليل المحلي. - للمصادقة كتطبيق Chat، اتّبِع الخطوات التالية:
إنشاء حساب خدمة
بيانات الاعتماد وحفظ بيانات الاعتماد كملف JSON
credentials.json
- للمصادقة كمستخدم Chat،
إنشاء معرِّف عميل OAuth
بيانات الاعتماد وحفظ بيانات الاعتماد كملف JSON
- اختر نطاق تفويض استنادًا إلى ما إذا كنت تريد المصادقة كمستخدم أو تطبيق 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 مثيلاً من
membership
بالتفصيل عن العضوية المحددة.
مواضيع ذات صلة
- قائمة الأعضاء في مساحة
- دعوة مستخدم أو تطبيق Chat أو إضافة إلى مساحة
- تعديل عضوية مستخدم في مساحة Google Chat
- إزالة مستخدم أو تطبيق في Chat من مساحة