إدراج أحداث من مساحة في Google Chat (original) (raw)

يوضّح هذا الدليل كيفية استخدام طريقةlist()في المورد SpaceEvent ضِمن Google Chat API لعرض التغييرات التي تم إجراؤها على الموارد في مساحة.

يمثّل مرجع SpaceEvent تغييرًا في المساحة المستهدَفة، بما في ذلك المراجع الفرعية للمساحة، مثل الرسائل والتفاعلات والعضويات. لمزيد من المعلومات حول قائمة أنواع الأحداث وحِزم بيانات الأحداث المتوافقة، يُرجى الاطّلاع على الحقلَين eventType وpayload في مستندات مرجع العنصر SpaceEvent.

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

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

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

Node.js

Python

عرض أحداث المساحة (مصادقة المستخدم)

لعرض أحداث المساحة من مساحة Chat، مرِّر ما يلي في طلبك:

يعرض المثال التالي أحداثًا حول العضويات والرسائل الجديدة في مساحة:

Node.js

لتشغيل هذا النموذج، استبدِل SPACE_NAME برقم التعريف من مساحةname. يمكنك الحصول على المعرّف من خلال استدعاء الطريقةListSpaces()أو من عنوان URL الخاص بالمساحة.

تعرض Chat API قائمة مقسّمة إلى صفحات بأحداث المساحة حول العضويات والرسائل الجديدة.

عرض قائمة بأحداث المساحة (مصادقة تطبيق Chat)

تتطلّب مصادقة التطبيق الحصول على موافقة المشرف لمرة واحدة.

لعرض قائمة بأحداث المساحة من مساحة تتضمّن مصادقة التطبيق وواجهة Chat REST API، عليك تضمين ما يلي في طلبك:

كتابة نص برمجي يستدعي Chat API

في ما يلي كيفية إدراج أحداث المساحة باستخدام مصادقة التطبيق وChat REST API:

Python

  1. في دليل العمل، أنشئ ملفًا باسم chat_spaceevents_list_app.py.
  2. أدرِج الرمز التالي في chat_spaceevents_list_app.py:
from google.oauth2 import service_account  
from apiclient.discovery import build  
# Define your app's authorization scopes.  
# Set authorization scopes based on the  
# event type. For example, if you are getting a space event  
# about a new membership, use the `chat.app.memberships` scope.  
#  
# When modifying these scopes, delete the file token.json, if it exists.  
SCOPES = ["https://www.googleapis.com/auth/chat.app.memberships",  
          "https://www.googleapis.com/auth/chat.app.memberships.readonly",  
          "https://www.googleapis.com/auth/chat.app.messages.readonly",  
          "https://www.googleapis.com/auth/chat.app.spaces",  
          "https://www.googleapis.com/auth/chat.app.spaces.readonly"]  
def main():  
    '''  
    Authenticates with Chat API using app authentication,  
    then lists space events from a specified space.  
    '''  
    # Specify service account details.  
    creds = (  
        service_account.Credentials.from_service_account_file('credentials.json')  
        .with_scopes(SCOPES)  
    )  
    # 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().list(  
        # The space to list events from.  
        #  
        # Replace SPACE_NAME with a space name.  
        # Obtain the space name from the spaces resource of Chat API,  
        # or from a space's URL.  
        parent='spaces/SPACE_NAME',  
        # A required filter. Filters events by event type.  
        #  
        # Update this filter to match your requirements.  
        filter='eventTypes:"google.workspace.chat.message.v1.created"'  
    ).execute()  
    # Print Chat API's response in your command line interface.  
    print(result)  
if __name__ == '__main__':  
    main()
  1. في الرمز، استبدِل ما يلي:
    • SPACE_NAME: اسم مساحة، ويمكنك الحصول عليه من خلال الطريقة spaces.list في Chat API، أو من عنوان URL الخاص بمساحة.
  2. في دليل العمل، أنشئ النموذج وشغِّله:
python3 chat_spaceevents_list_app.py

تعرض Chat API قائمة مقسّمة إلى صفحات بأحداث المساحة حول العضويات والرسائل الجديدة.