MCP Tools Reference: chatmcp.googleapis.com

เครื่องมือ: `list_messages`

ดึงข้อความจากการสนทนาใน Google Chat ที่ระบุ (พื้นที่ทำงาน ข้อความส่วนตัว (DM) หรือ DM กลุ่ม) อนุญาตให้กรองตามชุดข้อความ ช่วงเวลา และจำนวนข้อความ นอกจากนี้ยังสามารถดึงข้อความในหน้าถัดไปเพื่อดูบริบทเพิ่มเติมได้ด้วย ระบบจะกรองข้อความส่วนตัว (ข้อความที่ผู้ใช้คนเดียวเท่านั้นที่มองเห็น) ออก

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ list_messages MCP

คำขอ 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 }'

คำขอ 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
}'

สคีมาอินพุต

ข้อความคำขอสำหรับ RPC ListMessages

ListChatMessagesRequest

การแสดง JSON
{ "conversationId": string, "threadId": string, "pageSize": integer, "pageToken": string, "startTime": string, "endTime": string }

ช่อง
`conversationId`	`string` ต้องระบุ รหัสของการสนทนา การสนทนาอาจเป็นพื้นที่ทำงาน ข้อความส่วนตัว (DM) หรือ DM/แชทกลุ่ม รูปแบบ: spaces/{space}
`threadId`	`string` ไม่บังคับ รหัสของชุดข้อความที่เฉพาะเจาะจงภายในบทสนทนา หากระบุไว้ ระบบจะแสดงเฉพาะข้อความจากชุดข้อความนี้ หากไม่ระบุ ระบบจะพิจารณาข้อความจากชุดข้อความทั้งหมดในการสนทนา รูปแบบ: spaces/{space}/threads/{thread}
`pageSize`	`integer` ไม่บังคับ จำนวนข้อความสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะกำหนดค่าเริ่มต้นไว้ที่ 20 ค่าสูงสุดที่อนุญาตคือ 50
`pageToken`	`string` ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ list_messages ก่อนหน้า ระบุค่านี้เพื่อดึงข้อมูลหน้าถัดไป
`startTime`	`string` ไม่บังคับ การประทับเวลา ISO 8601 เพื่อกรองข้อความ ระบบจะแสดงเฉพาะข้อความที่สร้างขึ้นหลังจากเวลานี้เท่านั้น
`endTime`	`string` ไม่บังคับ การประทับเวลา ISO 8601 เพื่อกรองข้อความ ระบบจะแสดงเฉพาะข้อความที่สร้างขึ้นก่อนเวลานี้

สคีมาเอาต์พุต

ข้อความตอบกลับสำหรับ RPC ของ ListMessages

ListChatMessagesResponse

การแสดง JSON
{ "messages": [ { object (`ChatMessage`) } ], "nextPageToken": string }

ช่อง

ช่อง
`messages[]`	`object (ChatMessage)` รายการข้อความที่ดึงข้อมูลมา โดยเรียงตามลำดับเวลาจากใหม่ไปเก่าสุด
`nextPageToken`	`string` โทเค็นซึ่งส่งเป็น `page_token` ใน `ListMessagesRequest` ที่ตามมาเพื่อดึงข้อมูลข้อความในหน้าถัดไป หากช่องนี้ว่างเปล่า แสดงว่าไม่มีหน้าอื่นอีก

messages[]

object (ChatMessage)

รายการข้อความที่ดึงข้อมูลมา โดยเรียงตามลำดับเวลาจากใหม่ไปเก่าสุด

nextPageToken

string

โทเค็นซึ่งส่งเป็น page_token ใน ListMessagesRequest ที่ตามมาเพื่อดึงข้อมูลข้อความในหน้าถัดไป หากช่องนี้ว่างเปล่า แสดงว่าไม่มีหน้าอื่นอีก

ChatMessage

การแสดง JSON

การแสดง JSON
{ "messageId": string, "threadId": string, "plaintextBody": string, "sender": { object (`User`) }, "createTime": string, "threadedReply": boolean, "attachments": [ { object (`ChatAttachmentMetadata`) } ], "reactionSummaries": [ { object (`ReactionSummary`) } ] }

{
  "messageId": string,
  "threadId": string,
  "plaintextBody": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "threadedReply": boolean,
  "attachments": [
    {
      object (ChatAttachmentMetadata)
    }
  ],
  "reactionSummaries": [
    {
      object (ReactionSummary)
    }
  ]
}

ช่อง
`messageId`	`string` ชื่อทรัพยากรของข้อความ รูปแบบ: spaces/{space}/messages/{message}
`threadId`	`string` ชุดข้อความที่ข้อความนี้เป็นของ ฟิลด์นี้จะว่างเปล่าหากข้อความไม่ได้อยู่ในชุดข้อความ รูปแบบ: spaces/{space}/threads/{thread}
`plaintextBody`	`string` เนื้อหาข้อความแบบข้อความธรรมดา
`sender`	`object (User)` ผู้ส่งข้อความ
`createTime`	`string` เอาต์พุตเท่านั้น การประทับเวลาเมื่อสร้างข้อความ
`threadedReply`	`boolean` ไม่ว่าข้อความจะเป็นการตอบกลับชุดข้อความหรือไม่
`attachments[]`	`object (ChatAttachmentMetadata)` ไฟล์แนบที่รวมอยู่ในข้อความ
`reactionSummaries[]`	`object (ReactionSummary)` สรุปรีแอ็กชันด้วยอีโมจิที่รวมอยู่ในข้อความ

ผู้ใช้

การแสดง JSON
{ "userId": string, "displayName": string, "email": string, "userType": enum (`UserType`) }

ช่อง
`userId`	`string` ชื่อทรัพยากรของผู้ใช้ Chat รูปแบบ: users/{user}
`displayName`	`string` ชื่อที่แสดงของผู้ใช้ Chat
`email`	`string` อีเมลของผู้ใช้ ระบบจะป้อนข้อมูลในช่องนี้เมื่อประเภทผู้ใช้เป็น HUMAN เท่านั้น
`userType`	`enum (UserType)` ประเภทของผู้ใช้

ChatAttachmentMetadata

การแสดง JSON
{ "attachmentId": string, "filename": string, "mimeType": string, "source": enum (`Source`) }

ช่อง
`attachmentId`	`string` ชื่อทรัพยากรของไฟล์แนบ รูปแบบ: spaces/{space}/messages/{message}/attachments/{attachment}
`filename`	`string` ชื่อไฟล์แนบ
`mimeType`	`string` ประเภทเนื้อหา (ประเภท MIME)
`source`	`enum (Source)` แหล่งที่มาของไฟล์แนบ

การแสดง JSON
{ "emoji": string, "count": integer }

ช่อง

ช่อง
`emoji`	`string` สตริง Unicode อีโมจิหรือชื่ออีโมจิที่กำหนดเอง
`count`	`integer` จำนวนรีแอ็กชันทั้งหมดที่ใช้อีโมจิที่เชื่อมโยง

emoji

string

สตริง Unicode อีโมจิหรือชื่ออีโมจิที่กำหนดเอง

count

integer

จำนวนรีแอ็กชันทั้งหมดที่ใช้อีโมจิที่เชื่อมโยง

คำอธิบายประกอบเครื่องมือ

คำแนะนำที่ทำลายล้าง: ❌ | คำแนะนำที่ทำซ้ำได้: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบโลกเปิด: ❌