MCP Tools Reference: chatmcp.googleapis.com

도구: search_conversations

표시 이름으로 Google Chat 대화를 검색합니다.

참석자만 제공된 경우 이 도구는 지정된 참석자와 호출 사용자가 포함된 1:1 다이렉트 메시지 (참석자가 1명인 경우) 또는 그룹 채팅 (참석자가 여러 명인 경우)을 찾습니다.

쿼리만 제공된 경우 이 도구는 쿼리가 대소문자를 구분하지 않는 대화의 표시 이름의 하위 문자열인 대화를 검색합니다.

참여자 및 질문이 모두 제공되면 이 도구는 참여자별로 대화를 찾은 다음 표시 이름으로 필터링합니다.

참여자도 쿼리도 제공되지 않으면 이 도구는 호출 사용자가 회원인 모든 대화를 나열합니다.

이 도구에는 통화 사용자가 속한 대화만 표시됩니다.

중요: 'conversations' 목록이 비어 있다고 해서 전체적으로 더 이상 결과가 없다는 의미는 아닙니다. '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
}'

입력 스키마

FindConversations RPC의 요청 메시지입니다.

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

선택사항입니다. 발신자를 제외하고 대화를 필터링할 참여자의 이메일 주소 목록입니다.

출력 스키마

FindConversations RPC의 응답 메시지입니다.

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 형식의 대화 마지막 활성 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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 epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -62135596800~253402300799 (0001-01-01T00:00:00Z~9999-12-31T23:59:59Z) 사이여야 합니다.
nanos

integer

나노초 단위의 음수가 아닌 초수입니다. 이 필드는 기간의 나노초 부분이며 초의 대안이 아닙니다. 음수의 초수 값에는 시간에 반영되는 음수가 아닌 나노초 값이 있어야 합니다. 0~999,999,999(포함) 사이여야 합니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌