MCP Tools Reference: chatmcp.googleapis.com

Alat: search_conversations

Menelusuri percakapan Google Chat berdasarkan nama tampilan.

Jika hanya peserta yang diberikan, alat ini akan menemukan pesan langsung 1:1 (jika satu peserta diberikan) atau chat grup (jika beberapa peserta diberikan) yang menyertakan peserta yang ditentukan dan pengguna yang memanggil.

Jika hanya kueri yang diberikan, alat ini akan menelusuri percakapan yang kuerinya merupakan substring yang tidak peka huruf besar/kecil dari nama tampilan percakapan.

Jika peserta dan kueri diberikan, alat ini akan menemukan percakapan berdasarkan peserta, lalu memfilternya berdasarkan nama tampilan.

Jika peserta maupun kueri tidak diberikan, alat ini akan mencantumkan semua percakapan yang diikuti oleh pengguna yang melakukan panggilan.

Alat ini hanya mencantumkan percakapan yang diikuti oleh pengguna yang melakukan panggilan.

PENTING: Daftar 'conversations' yang kosong tidak berarti tidak ada lagi hasil secara keseluruhan. Jika 'next_page_token' ada, halaman lainnya dapat diambil. Jika Anda mendapatkan daftar kosong, tetapi 'next_page_token', tanyakan kepada pengguna apakah Anda harus melanjutkan penelusuran.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP search_conversations.

Permintaan 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
}'

Skema Input

Pesan permintaan untuk RPC FindConversations.

SearchConversationsRequest

Representasi JSON 
{
  "spaceNameQuery": string,
  "pageSize": integer,
  "pageToken": string,
  "participants": [
    string
  ]
}
Kolom
spaceNameQuery

string

Opsional. Teks yang akan ditelusuri dalam nama tampilan ruang.
pageSize

integer

Opsional. Jumlah maksimum ruang yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 100 ruang akan ditampilkan. Nilai maksimum adalah 1.000; nilai di atas 1.000 akan dikonversi menjadi 1.000.
pageToken

string

Opsional. Token halaman, yang diterima dari panggilan search_conversations sebelumnya. Berikan ini untuk mengambil halaman selanjutnya.
participants[]

string

Opsional. Daftar alamat email peserta untuk memfilter percakapan, tidak termasuk pemanggil.

Skema Output

Pesan respons untuk RPC FindConversations.

SearchConversationsResponse

Representasi JSON 
{
  "conversations": [
    {
      object (Conversation)
    }
  ],
  "nextPageToken": string
}
Kolom
conversations[]

object (Conversation)

Daftar objek percakapan yang cocok dengan kriteria penelusuran.
nextPageToken

string

Token yang dapat dikirim sebagai page_token untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak akan ada halaman berikutnya.

Percakapan

Representasi JSON 
{
  "conversationId": string,
  "displayName": string,
  "conversationType": enum (ConversationType),
  "lastActiveTimestamp": string
}
Kolom
conversationId

string

ID percakapan (misalnya, "spaces/AAAAAAAAA").
displayName

string

Nama tampilan percakapan.
conversationType

enum (ConversationType)

Jenis percakapan (DIRECT_MESSAGE, GROUP_CHAT, atau NAMED_SPACE).
lastActiveTimestamp

string (Timestamp format)

Waktu terakhir percakapan aktif dalam format ISO 8601.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌