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

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

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

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

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

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

Python

  • ธุรกิจหรือองค์กร บัญชี Google Workspace ที่มีสิทธิ์เข้าถึง Google Chat
  • Python 3.6 ขึ้นไป
  • เครื่องมือจัดการแพ็กเกจ pip
  • ไลบรารีของไคลเอ็นต์ Google ล่าสุด หากต้องการติดตั้งหรืออัปเดตส่วนขยาย เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง
    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

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

หากต้องการดูรายละเอียดเกี่ยวกับ 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 พร้อมรายละเอียดเกี่ยวกับกิจกรรม