MCP Tools Reference: chatmcp.googleapis.com

Strumento: search_messages

Cerca messaggi di Google Chat utilizzando parole chiave e filtri. Funziona in tutti gli spazi a cui l'utente ha accesso o può essere limitato a una conversazione specifica.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP search_messages.

Richiesta 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_messages",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Richiedi di cercare messaggi di Google Chat utilizzando parole chiave e filtri. Funziona in tutti gli spazi a cui l'utente ha accesso o può essere limitato a una conversazione specifica.

SearchMessagesRequest

Rappresentazione JSON 
{
  "searchParameters": {
    object (SearchParameters)
  },
  "pageSize": integer,
  "pageToken": string
}
Campi
searchParameters

object (SearchParameters)

Obbligatorio. I parametri di ricerca da utilizzare per la ricerca.
pageSize

integer

Facoltativo. Il numero massimo di risultati da restituire (fino a 100). Se non specificato, vengono restituiti al massimo 25 risultati.
pageToken

string

Facoltativo. Un token di pagina ricevuto da una precedente chiamata search_messages. Forniscilo per recuperare la pagina successiva.

SearchParameters

Rappresentazione JSON 
{
  "keywords": [
    string
  ],
  "conversationId": string,
  "sender": string,
  "isUnread": boolean,
  "hasLink": boolean,
  "startTime": string,
  "endTime": string,
  "mentionsMe": boolean,
  "conversationIncludesUser": string,
  "spaceDisplayNames": [
    string
  ]
}
Campi
keywords[]

string

Facoltativo. Un insieme di parole chiave utilizzate per filtrare i risultati.
conversationId

string

Facoltativo. Limita la ricerca a un identificatore di conversazione specifico, restituito dallo strumento search_conversations. Formato: spaces/{ID}.
sender

string

Facoltativo. Filtra i messaggi di un utente specifico. Puoi utilizzare l'email o il nome della risorsa del mittente. I nomi delle risorse utente sono formattati come users/{ID}, dove {ID} può essere un ID persona o il suo indirizzo email.
isUnread

boolean

Facoltativo. Filtra i messaggi che non sono stati letti dall'utente chiamante.
hasLink

boolean

Facoltativo. Filtra i messaggi contenenti almeno un URL.
startTime

string

Facoltativo. Filtra i messaggi creati dopo questo orario. Formato: timestamp ISO 8601.
endTime

string

Facoltativo. Filtra i messaggi creati prima di questo orario. Formato: timestamp ISO 8601.
mentionsMe

boolean

Facoltativo. Filtra i messaggi che menzionano esplicitamente l'utente che chiama.
conversationIncludesUser

string

Facoltativo. Filtra i messaggi nei messaggi diretti e nelle chat di gruppo che includono l'email o l'ID utente specifico.
spaceDisplayNames[]

string

Facoltativo. Filtra in base a un elenco di nomi di spazi; i nomi visualizzati degli spazi vengono abbinati parzialmente. Nota: vengono restituite solo le prime 5 corrispondenze.

Schema di output

Risposta alla ricerca di messaggi di Google Chat. Se next_page_token è compilato, SearchMessages può essere chiamato di nuovo con quel token per recuperare la pagina successiva dei risultati.

SearchMessagesResponse

Rappresentazione JSON 
{
  "messages": [
    {
      object (ChatMessage)
    }
  ],
  "nextPageToken": string
}
Campi
messages[]

object (ChatMessage)

Elenco degli oggetti dei messaggi che corrispondono ai criteri di ricerca.
nextPageToken

string

Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

ChatMessage

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

string

Nome della risorsa del messaggio. Formato: spaces/{space}/messages/{message}
threadId

string

Il thread a cui appartiene questo messaggio. Questo campo sarà vuoto se il messaggio non è in thread. Formato: spaces/{space}/threads/{thread}
plaintextBody

string

Corpo del messaggio utilizzando la formattazione Markdown.
sender

object (User)

Il mittente del messaggio.
createTime

string

Solo output. Timestamp di creazione del messaggio.
threadedReply

boolean

Indica se il messaggio è una risposta a un thread.
attachments[]

object (ChatAttachmentMetadata)

Allegati inclusi nel messaggio.
reactionSummaries[]

object (ReactionSummary)

Il riepilogo delle reazioni con emoji incluso nel messaggio.

Utente

Rappresentazione JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Campi
userId

string

Nome risorsa di un utente di Chat. Formato: users/{user}.
displayName

string

Il nome visualizzato di un utente di Chat.
email

string

L'indirizzo email dell'utente. Questo campo viene compilato solo quando il tipo di utente è HUMAN.
userType

enum (UserType)

Il tipo di utente.

ChatAttachmentMetadata

Rappresentazione JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Campi
attachmentId

string

Nome della risorsa dell'allegato. Formato: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Nome dell'allegato.
mimeType

string

Tipo di contenuti (tipo MIME).
source

enum (Source)

L'origine dell'allegato.

ReactionSummary

Rappresentazione JSON 
{
  "emoji": string,
  "count": integer
}
Campi
emoji

string

La stringa Unicode dell'emoji o il nome dell'emoji personalizzata.
count

integer

Il numero totale di reazioni che utilizzano l'emoji associata.

UserType

Il tipo di utente di Google Chat.

Enum
USER_TYPE_UNSPECIFIED Non specificato.
HUMAN Utente umano.
APP Utente dell'app.

Origine

L'origine dell'allegato.

Enum
SOURCE_UNSPECIFIED Riservati.
DRIVE_FILE Il file è un file di Google Drive.
UPLOADED_CONTENT Il file viene caricato su Chat.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌