الحصول على تفاصيل عن حدث في مساحة Google Chat

يشرح هذا الدليل كيفية استخدام تم تفعيل إجراء get SpaceEvent المرجع الخاص بـ Google Chat API للحصول على تفاصيل حول حدث ما من مساحة Google Chat

يمثّل المورد SpaceEvent تغييرًا في مساحة أو تابعة لها. الموارد، مثل الرسائل والتفاعلات والاشتراكات. للتعلّم عن أنواع الأحداث المتوافقة، راجِع الحقل eventType في SpaceEvent مورد الوثائق المرجعية.

يمكنك طلب أحداث تصل مدتها إلى 28 يومًا قبل وقت الطلب. الفعالية يحتوي على أحدث إصدار من المورد الذي تم تغييره. على سبيل المثال، إذا طلبت حدثًا حول رسالة جديدة ولكن تم تحديث الرسالة لاحقًا، يعرض الخادم مورد Message المُحدّث في حمولة الحدث.

لاستدعاء هذه الطريقة، يجب استخدام user المصادقة. للحصول على الحدث، يجب أن يكون المستخدم الذي تمت مصادقته عضوًا في المساحة التي يقع فيها الحدث حدث.

المتطلبات الأساسية

Python

  • Python 3.6 أو أعلى
  • أداة إدارة حزم pip
  • أحدث مكتبات عملاء Google. لتثبيت التطبيقات أو تحديثها، قم بتشغيل الأمر التالي في واجهة سطر الأوامر: 
    pip3 install --upgrade google-api-python-client google-auth-oauthlib

الحصول على تفاصيل حول حدث في الفضاء

للحصول على تفاصيل عن SpaceEvent في Google Chat، اتّبِع الخطوات التالية:

  • يمكنك استدعاء طريقة get. في SpaceEvent
  • عليك اجتياز name من SpaceEvent للحصول على المستوى. الحصول على اسم SpaceEvent من SpaceEvent المصدر الخاص بـ Google Chat
  • مع مستخدم المصادقة، أو تحديد نطاق تفويض يدعم نوع الحدث في طلبك. نتيجة لذلك، أُنشئت مكتبة مات بلوت ليب في أفضل الممارسات، اختَر النطاق الأكثر تقييدًا الذي يظل يسمح لتطبيقك للعمل.

إليك كيفية الحصول على SpaceEvent باستخدام مصادقة المستخدم:

Python

  1. في دليل العمل، أنشِئ ملفًا باسم "chat_space_event_get.py".

  2. أدرِج الرمز التالي في 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)

  3. في الرمز، استبدل ما يلي:

    • 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.

  4. في دليل العمل، أنشئ النموذج وشغِّله:

    python3 chat_space_event_get.py

تعرض واجهة برمجة التطبيقات Chat مثيلاً من SpaceEvent تحتوي على تفاصيل حول الحدث.