Xem thông tin chi tiết về một sự kiện trong phòng Google Chat

Hướng dẫn này giải thích cách sử dụng Phương thức get đang bật SpaceEvent của API Google Chat để lấy thông tin chi tiết về một sự kiện từ một phòng Google Chat.

Tài nguyên SpaceEvent biểu thị một thay đổi đối với một không gian hoặc phần tử con của không gian đó chẳng hạn như tin nhắn, lượt thể hiện cảm xúc và gói hội viên. Để tìm hiểu về các loại sự kiện được hỗ trợ, hãy xem trường eventType của Tài nguyên SpaceEvent tài liệu tham khảo.

Bạn có thể yêu cầu sự kiện trước thời điểm yêu cầu tối đa 28 ngày. Sự kiện chứa phiên bản gần đây nhất của tài nguyên đã thay đổi. Ví dụ: nếu bạn yêu cầu một sự kiện về một tin nhắn mới nhưng sau đó tin nhắn đó đã được cập nhật, máy chủ sẽ trả về tài nguyên Message đã cập nhật trong tải trọng sự kiện.

Để gọi phương thức này, bạn phải sử dụng hàm user xác thực. Để nhận được sự kiện, người dùng xác thực phải là thành viên của không gian nơi sự kiện diễn ra đã xảy ra.

Điều kiện tiên quyết

Python

  • Python 3.6 trở lên
  • Công cụ quản lý gói pip
  • Thư viện ứng dụng mới nhất của Google. Cách cài đặt hoặc cập nhật các tính năng này: chạy lệnh sau trong giao diện dòng lệnh:
    pip3 install --upgrade google-api-python-client google-auth-oauthlib
    

Xem thông tin chi tiết về sự kiện trên không gian

Cách xem thông tin chi tiết về SpaceEvent trong Google Chat:

  • Gọi phương thức get trên SpaceEvent .
  • Truyền name của SpaceEvent để lấy. Lấy tên SpaceEvent từ SpaceEvent tài nguyên/ Google Chat.
  • Với người dùng xác thực, chỉ định phạm vi uỷ quyền hỗ trợ loại sự kiện trong yêu cầu của bạn. Là một phương pháp hay nhất, chọn phạm vi hạn chế nhất mà vẫn cho phép ứng dụng của bạn để hoạt động.

Sau đây là cách nhận SpaceEvent bằng xác thực người dùng:

Python

  1. Trong thư mục đang làm việc, hãy tạo một tệp có tên chat_space_event_get.py.
  2. Đưa mã sau vào 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. Trong mã, thay thế các nội dung sau:

  4. Trong thư mục đang làm việc, hãy tạo và chạy mẫu:

    python3 chat_space_event_get.py
    

API Chat trả về một phiên bản của SpaceEvent kèm theo thông tin chi tiết về sự kiện.