ดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ใน Google Chat

คำแนะนำนี้จะอธิบายวิธีใช้เมธอด get ในSpaceEventทรัพยากรของ Google Chat API เพื่อดูรายละเอียดเกี่ยวกับกิจกรรมจากพื้นที่ใน Google Chat

ทรัพยากร SpaceEvent แสดงถึงการเปลี่ยนแปลงของพื้นที่ทำงานหรือทรัพยากรย่อย เช่น ข้อความ รีแอ็กชัน และการเป็นสมาชิก ดูข้อมูลเกี่ยวกับประเภทเหตุการณ์ที่รองรับได้ที่ช่อง eventType ในเอกสารอ้างอิงสำหรับแหล่งข้อมูล SpaceEvent

คุณขอกิจกรรมได้สูงสุด 28 วันก่อนเวลาที่ขอ เหตุการณ์นี้มีทรัพยากรเวอร์ชันล่าสุดที่มีการเปลี่ยนแปลง เช่น หากคุณขอเหตุการณ์เกี่ยวกับข้อความใหม่ แต่ข้อความได้รับการอัปเดตในภายหลัง เซิร์ฟเวอร์จะส่งกลับทรัพยากร Message ที่อัปเดตแล้วในเพย์โหลดของเหตุการณ์

หากต้องการเรียกใช้วิธีการนี้ คุณต้องใช้การตรวจสอบสิทธิ์ผู้ใช้ หากต้องการรับเหตุการณ์ ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วต้องเป็นสมาชิกของพื้นที่ทำงานที่เกิดเหตุการณ์ขึ้น

ข้อกำหนดเบื้องต้น

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 แล้ว การรับ กิจกรรมพื้นที่ทำงานจะต้องมีการตรวจสอบสิทธิ์ผู้ใช้ โดยมีขอบเขตที่รองรับประเภทเหตุการณ์ หากต้องการเลือกขอบเขต โปรดดูภาพรวมการตรวจสอบสิทธิ์และการให้สิทธิ์

ดูรายละเอียดเกี่ยวกับกิจกรรมในพื้นที่ทำงาน

หากต้องการดูรายละเอียดเกี่ยวกับ 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 API จะส่งคืนอินสแตนซ์ของ SpaceEvent พร้อมรายละเอียดเกี่ยวกับเหตุการณ์