MCP Tools Reference: chatmcp.googleapis.com

工具：search_conversations

依顯示名稱搜尋 Google Chat 對話。

如果只提供參與者，這項工具會找出包含指定參與者和通話使用者的 1 對 1 即時訊息 (如果只提供一位參與者) 或群組對話 (如果提供多位參與者)。

如果只提供查詢，這項工具會搜尋對話，其中查詢是不區分大小寫的對話顯示名稱子字串。

如果同時提供參與者和查詢，這項工具會先依參與者尋找對話，然後依顯示名稱篩選。

如果未提供參與者或查詢，這項工具會列出通話使用者所屬的所有對話。

這項工具只會列出通話使用者所屬的對話。

重要事項：如果「對話」清單為空白，不代表沒有其他結果。如果存在「next_page_token」，則可擷取更多頁面。如果清單為空白，但有「next_page_token」，請詢問使用者是否要繼續搜尋。

以下範例示範如何使用 curl 叫用 search_conversations MCP 工具。

Curl 要求 
curl --location 'https://chatmcp.googleapis.com/mcp/v1' \
--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
}'

輸入內容的結構定義

FindConversations 遠端程序呼叫的要求訊息。

SearchConversationsRequest

JSON 表示法 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
欄位
spaceNameQuery

string

(選用步驟) 要在空間顯示名稱中搜尋的文字。
pageSize

integer

(選用步驟) 要傳回的空間數量上限。服務傳回的產品數量可能會少於這個值。如未指定，最多將傳回 100 個空間。許可的最大值為 1000；超出的數值將一律指定為 1000。
pageToken

string

(選用步驟) 屬於接收自前一個 search_conversations 呼叫的網頁權杖。提供此項目即可擷取後續網頁。
participants[]

string

(選用步驟) 要篩選對話的參與者電子郵件地址清單 (不含來電者)。

輸出內容的結構定義

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

對話的 ID (例如「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)

代表自 Unix 紀元 1970-01-01T00:00:00Z 起算的世界標準時間秒數。必須介於 -62135596800 和 253402300799 之間 (含)，對應至 0001-01-01T00:00:00Z 至 9999-12-31T23:59:59Z。
nanos

integer

以奈秒為單位的非負秒數小數。這個欄位是時間長度的奈秒部分，並非秒數的替代值。如果秒數值為負數，且包含小數，奈秒值仍須為非負數，且會向前計時。必須介於 0 至 999,999,999 之間 (含)。

ConversationType

定義對話類型。

列舉
CONVERSATION_TYPE_UNSPECIFIED 未指明
NAMED_SPACE 具名空間。
GROUP_CHAT 三位以上使用者進行的群組對話。
DIRECT_MESSAGE 兩位使用者之間的即時訊息，或使用者與 Chat 應用程式之間的即時訊息。

工具註解

破壞性提示：❌ | 等冪提示：✅ | 唯讀提示：✅ | 開放世界提示：❌