MCP Tools Reference: chatmcp.googleapis.com

เครื่องมือ: search_conversations

ค้นหาการสนทนาใน Google Chat ตามชื่อที่แสดง

หากระบุเฉพาะผู้เข้าร่วม เครื่องมือนี้จะค้นหาข้อความส่วนตัวแบบ 1:1 (หากระบุผู้เข้าร่วม 1 คน) หรือแชทกลุ่ม (หากระบุผู้เข้าร่วมหลายคน) ที่มีผู้เข้าร่วมที่ระบุและผู้ใช้ที่โทร

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

หากระบุทั้งผู้เข้าร่วมและคำค้นหา เครื่องมือนี้จะค้นหาการสนทนาตามผู้เข้าร่วม แล้วกรองตามชื่อที่แสดง

หากไม่ได้ระบุทั้งผู้เข้าร่วมและคำค้นหา เครื่องมือนี้จะแสดงรายการการสนทนาทั้งหมดที่ผู้ใช้ที่เรียกใช้เป็นสมาชิก

เครื่องมือนี้จะแสดงเฉพาะการสนทนาที่ผู้ใช้ที่โทรเป็นสมาชิกอยู่

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

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ search_conversations 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": "search_conversations",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

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

SearchConversationsRequest

การแสดง JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
ฟิลด์
spaceNameQuery

string

ไม่บังคับ ข้อความที่จะค้นหาในชื่อที่แสดงของพื้นที่ทำงาน
pageSize

integer

ไม่บังคับ จำนวนพื้นที่สูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลสเปซอย่างมาก 100 รายการ ค่าสูงสุดคือ 1,000 และค่าที่สูงกว่า 1,000 จะถูกบังคับให้เป็น 1,000
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ search_conversations ก่อนหน้า ระบุค่านี้เพื่อดึงข้อมูลหน้าถัดไป
participants[]

string

ไม่บังคับ รายชื่ออีเมลของผู้เข้าร่วมเพื่อกรองการสนทนา โดยไม่รวมผู้โทร

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

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

SearchConversationsResponse

การแสดง JSON 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
ช่อง
conversations[]

object (Conversation)

รายการออบเจ็กต์การสนทนาที่ตรงกับเกณฑ์การค้นหา
nextPageToken

string

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

การสนทนา

การแสดง JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
ช่อง
conversationId

string

รหัสของการสนทนา (เช่น "spaces/AAAAAAAAA")
displayName

string

ชื่อที่แสดงของการสนทนา
conversationType

enum (ConversationType)

ประเภทการสนทนา (DIRECT_MESSAGE, GROUP_CHAT หรือ NAMED_SPACE)
lastActiveTimestamp

string (Timestamp format)

เวลาที่การสนทนาใช้งานล่าสุดในรูปแบบ ISO 8601

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

การประทับเวลา

การแสดง JSON 
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง -62135596800 ถึง 253402300799 เท่านั้น (ซึ่งสอดคล้องกับ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z)
nanos

integer

เศษส่วนของวินาทีที่ไม่เป็นค่าลบที่ความละเอียดระดับนาโนวินาที ฟิลด์นี้คือส่วนของระยะเวลาในหน่วยนาโนวินาที ไม่ใช่หน่วยวินาที ค่าวินาทีที่เป็นลบซึ่งมีเศษส่วนยังคงต้องมีค่านาโนที่เป็นค่าบวกซึ่งนับไปข้างหน้าตามเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 เท่านั้น

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

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