يشرح هذا الدليل كيفية استخدام
تم تفعيل إجراء get
SpaceEvent
المرجع الخاص بـ
Google Chat API للحصول على تفاصيل حول حدث ما من مساحة Google Chat
يمثّل المورد SpaceEvent
تغييرًا في مساحة أو تابعة لها.
الموارد، مثل الرسائل والتفاعلات والاشتراكات. للتعلّم
عن أنواع الأحداث المتوافقة، راجِع الحقل eventType
في
SpaceEvent
مورد
الوثائق المرجعية.
يمكنك طلب أحداث تصل مدتها إلى 28 يومًا قبل وقت الطلب. الفعالية
يحتوي على أحدث إصدار من المورد الذي تم تغييره. على سبيل المثال، إذا
طلبت حدثًا حول رسالة جديدة ولكن تم تحديث الرسالة لاحقًا،
يعرض الخادم مورد Message
المُحدّث في حمولة الحدث.
لاستدعاء هذه الطريقة، يجب استخدام user المصادقة. للحصول على الحدث، يجب أن يكون المستخدم الذي تمت مصادقته عضوًا في المساحة التي يقع فيها الحدث حدث.
المتطلبات الأساسية
Python
- نشاط تجاري أو مؤسسة حساب Google Workspace لديه إذن بالوصول إلى Google Chat
- إعداد البيئة:
- أنشِئ مشروعًا على Google Cloud.
- ضبط شاشة موافقة OAuth
- تفعيل Google Chat API وضبطه باستخدام اسم ورمزه ووصفه لتطبيق Chat.
-
أنشئ بيانات اعتماد معرِّف عميل OAuth لتطبيق متوافق مع الكمبيوتر المكتبي. لتنفيذ النموذج في هذه
هذا الدليل، فاحفظ بيانات الاعتماد كملف JSON اسمه
client_secrets.json
في الدليل المحلي.
- اختر نطاق تفويض يتيح مصادقة المستخدم.
الحصول على تفاصيل حول حدث في الفضاء
للحصول على تفاصيل عن SpaceEvent
في Google Chat، اتّبِع الخطوات التالية:
- يمكنك استدعاء طريقة
get
. فيSpaceEvent
- عليك اجتياز
name
منSpaceEvent
للحصول على المستوى. الحصول على اسمSpaceEvent
منSpaceEvent
المصدر الخاص بـ Google Chat - مع مستخدم المصادقة، أو تحديد نطاق تفويض يدعم نوع الحدث في طلبك. نتيجة لذلك، أُنشئت مكتبة مات بلوت ليب في أفضل الممارسات، اختَر النطاق الأكثر تقييدًا الذي يظل يسمح لتطبيقك للعمل.
إليك كيفية الحصول على SpaceEvent
باستخدام
مصادقة المستخدم:
Python
- في دليل العمل، أنشِئ ملفًا باسم "
chat_space_event_get.py
". أدرِج الرمز التالي في
chat_space_event_get.py
:"""Gets a SpaceEvent resource from the Chat API.""" 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 = ['SCOPE'] # 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() .spaceEvents() .get( # The space event 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 SPACE_EVENT with a SpaceEvent name. # Obtain the spaceEvent name from the SpaceEvent resource of # Chat API. name='spaces/SPACE/spaceEvents/SPACE_EVENT' ) .execute() ) # Prints details about the created spaceEvent. print(result)
في الرمز، استبدل ما يلي:
SCOPE
: نطاق تفويض يستند إلى نوع الحدث. على سبيل المثال، إذا كنت تستضيف حدثًا في الفضاء حول العضوية الجديدة، استخدِم نطاقchat.memberships.readonly
بتنسيقhttps://www.googleapis.com/auth/chat.memberships.readonly
. يمكنك الحصول على نوع الحدث من طريقةspaces.spaceEvents.list
. لمعرفة كيفية استخدام هذه الطريقة، راجع سرد أحداث من مساحةSPACE
: اسم مساحة يمكنك الحصول عليه من طريقةspaces.list
في Chat API أو من عنوان URL للمساحة.SPACE_EVENT
: اسم المساحة والذي يمكنك الحصول عليه من طريقةspaces.spaceEvents.list
.
في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_space_event_get.py
تعرض واجهة برمجة التطبيقات Chat مثيلاً من
SpaceEvent
تحتوي على تفاصيل حول الحدث.