Liệt kê tin nhắn

Hướng dẫn này giải thích cách sử dụng phương thức list trên tài nguyên Message của API Google Chat để xem danh sách tin nhắn được phân trang, có thể lọc trong một không gian.

Trong API Chat, tin nhắn trong Chat được biểu thị bằng Tài nguyên Message. Mặc dù người dùng Chat chỉ có thể gửi tin nhắn có chứa văn bản, Các ứng dụng nhắn tin có thể dùng nhiều tính năng nhắn tin khác, bao gồm hiển thị giao diện người dùng tĩnh hoặc tương tác, thu thập thông tin từ và gửi thư một cách riêng tư. Để tìm hiểu thêm về tính năng nhắn tin các tính năng dành cho API Chat, hãy xem Tổng quan về tin nhắn trong Google Chat.

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

Python

Liệt kê tin nhắn

Để liệt kê thông báo bằng xác thực người dùng, chuyển nội dung sau vào yêu cầu của bạn:

Ví dụ sau đây liệt kê các tin nhắn trong một phòng Chat được gửi sau Ngày 16 tháng 3 năm 2023:

Python

  1. Trong thư mục đang làm việc, hãy tạo một tệp có tên chat_messages_list.py.

  2. Đưa mã sau vào chat_messages_list.py:

    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 = ["https://www.googleapis.com/auth/chat.messages.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then lists messages in a space sent after March 16, 2023.
    '''

    # 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().messages().list(

          # The space for which to list messages.
          parent = 'spaces/SPACE',

          # An optional filter that returns messages
          # created after March 16, 2023.
          filter = 'createTime > "2023-03-16T00:00:00-00:00"'

      ).execute()

    # Prints the list of messages.
    print(result)

if __name__ == '__main__':
    main()

  3. Trong mã, thay thế SPACE bằng tên không gian, mà bạn có thể lấy từ Phương thức spaces.list trong API Chat hoặc qua URL của một không gian.

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

    python3 chat_messages_list.py

API Chat trả về danh sách tin nhắn được gửi trong không gian được chỉ định sau ngày 16 tháng 3 năm 2023. Nếu không có tin nhắn nào từ yêu cầu, Phản hồi của API Chat trả về một đối tượng trống. Khi sử dụng Giao diện REST/HTTP, phản hồi có chứa đối tượng JSON trống, {}.