MCP Tools Reference: chatmcp.googleapis.com

Công cụ: list_messages

Truy xuất tin nhắn từ một cuộc trò chuyện cụ thể trên Google Chat (Không gian, tin nhắn trực tiếp (DM) hoặc tin nhắn trực tiếp theo nhóm). Cho phép lọc theo chuỗi, phạm vi thời gian và số lượng tin nhắn. Ngoài ra, bạn có thể truy xuất trang tin nhắn tiếp theo để có thêm ngữ cảnh. Tin nhắn riêng tư (tin nhắn chỉ hiển thị cho một người dùng) sẽ bị lọc.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP list_messages.

Yêu cầu Curl 
curl --location 'https://chatmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_messages",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

Thông báo yêu cầu cho ListMessages RPC.

ListChatMessagesRequest

Biểu diễn dưới dạng JSON 
{
  "conversationId": string,
  "threadId": string,
  "pageSize": integer,
  "pageToken": string,
  "startTime": string,
  "endTime": string
}
Trường
conversationId

string

Bắt buộc. Mã của cuộc trò chuyện. Cuộc trò chuyện có thể là không gian, tin nhắn trực tiếp (DM) hoặc tin nhắn trực tiếp theo nhóm/Chat. Định dạng: spaces/{space}
threadId

string

Không bắt buộc. Mã của một chuỗi cụ thể trong cuộc trò chuyện. Nếu được cung cấp, chỉ những tin nhắn trong chuỗi này mới được trả về. Nếu bạn bỏ qua, hệ thống sẽ xem xét tin nhắn từ tất cả các chuỗi trong cuộc trò chuyện. Định dạng: spaces/{space}/threads/{thread}
pageSize

integer

Không bắt buộc. Số lượng tin nhắn tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Nếu bạn không chỉ định, giá trị mặc định là 20. Giá trị tối đa được phép là 50.
pageToken

string

Không bắt buộc. Mã thông báo trang nhận được từ lệnh gọi list_messages trước đó. Cung cấp mã này để truy xuất trang tiếp theo.
startTime

string

Không bắt buộc. Dấu thời gian ISO 8601 để lọc tin nhắn. Chỉ những tin nhắn được tạo sau thời gian này mới được trả về.
endTime

string

Không bắt buộc. Dấu thời gian ISO 8601 để lọc tin nhắn. Chỉ những tin nhắn được tạo trước thời gian này mới được trả về.

Giản đồ đầu ra

Thông báo phản hồi cho ListMessages RPC.

ListChatMessagesResponse

Biểu diễn dưới dạng JSON 
{
  "messages": [
    {
      object (ChatMessage)
    }
  ],
  "nextPageToken": string
}
Trường
messages[]

object (ChatMessage)

Danh sách tin nhắn đã truy xuất, theo thứ tự thời gian đảo ngược (mới nhất trước).
nextPageToken

string

Mã thông báo có thể được gửi dưới dạng page_token trong ListMessagesRequest tiếp theo để truy xuất trang tin nhắn tiếp theo. Nếu trường này trống, thì không còn trang nào nữa.

ChatMessage

Biểu diễn dưới dạng JSON 
{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}
Trường
messageId

string

Tên tài nguyên của tin nhắn. Định dạng: spaces/{space}/messages/{message}
threadId

string

Chuỗi mà tin nhắn này thuộc về. Trường này sẽ trống nếu tin nhắn không thuộc chuỗi. Định dạng: spaces/{space}/threads/{thread}
plaintextBody

string

Nội dung văn bản thuần tuý của tin nhắn.
sender

object (User)

Người gửi tin nhắn.
createTime

string

Chỉ có đầu ra. Dấu thời gian khi tin nhắn được tạo.
threadedReply

boolean

Tin nhắn có phải là tin nhắn trả lời trong chuỗi hay không.
attachments[]

object (ChatAttachmentMetadata)

Tệp đính kèm có trong tin nhắn.
reactionSummaries[]

object (ReactionSummary)

Tóm tắt về các lượt thể hiện cảm xúc bằng biểu tượng cảm xúc có trong tin nhắn.

Người dùng

Biểu diễn dưới dạng JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Trường
userId

string

Tên tài nguyên của người dùng Chat. Định dạng: users/{user}.
displayName

string

Tên hiển thị của người dùng Chat.
email

string

Địa chỉ email của người dùng. Trường này chỉ được điền khi loại người dùng là HUMAN.
userType

enum (UserType)

Loại người dùng.

ChatAttachmentMetadata

Biểu diễn dưới dạng JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Trường
attachmentId

string

Tên tài nguyên của tệp đính kèm. Định dạng: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Tên của tệp đính kèm.
mimeType

string

Loại nội dung (loại MIME).
source

enum (Source)

Nguồn của tệp đính kèm.

ReactionSummary

Biểu diễn dưới dạng JSON 
{
  "emoji": string,
  "count": integer
}
Trường
emoji

string

Chuỗi unicode biểu tượng cảm xúc hoặc tên biểu tượng cảm xúc tuỳ chỉnh.
count

integer

Tổng số lượt thể hiện cảm xúc bằng biểu tượng cảm xúc được liên kết.

Chú thích công cụ

Gợi ý mang tính phá hoại: ❌ | Gợi ý về tính lũy đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌