MCP Tools Reference: chatmcp.googleapis.com

Strumento: list_messages

Recupera i messaggi da una conversazione di Google Chat specificata (spazio, messaggio diretto o messaggio diretto di gruppo). Consente di filtrare per thread, intervallo di tempo e numero di messaggi. Inoltre, è possibile recuperare la pagina successiva dei messaggi per fornire un contesto più ampio. I messaggi privati (messaggi visibili solo a un singolo utente) vengono filtrati.

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

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

Schema di input

Messaggio di richiesta per la RPC ListMessages.

ListChatMessagesRequest

Rappresentazione JSON 
{
  "conversationId": string,
  "threadId": string,
  "pageSize": integer,
  "pageToken": string,
  "startTime": string,
  "endTime": string
}
Campi
conversationId

string

Obbligatorio. L'ID della conversazione. Una conversazione può essere uno spazio, un messaggio diretto o un messaggio diretto di gruppo/Chat. Formato: spaces/{space}
threadId

string

Facoltativo. L'ID di un thread specifico all'interno della conversazione. Se fornito, verranno restituiti solo i messaggi di questo thread. Se omesso, vengono presi in considerazione i messaggi di tutti i thread della conversazione. Formato: spaces/{space}/threads/{thread}
pageSize

integer

Facoltativo. Il numero massimo di messaggi da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, il valore predefinito è 20. Il valore massimo consentito è 50.
pageToken

string

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

string

Facoltativo. Timestamp ISO 8601 per filtrare i messaggi. Verranno restituiti solo i messaggi creati dopo questo orario.
endTime

string

Facoltativo. Timestamp ISO 8601 per filtrare i messaggi. Verranno restituiti solo i messaggi creati prima di questo orario.

Schema di output

Messaggio di risposta per la RPC ListMessages.

ListChatMessagesResponse

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

object (ChatMessage)

Elenco dei messaggi recuperati, in ordine cronologico inverso (i più recenti per primi).
nextPageToken

string

Un token, che può essere inviato come page_token in una successiva ListMessagesRequest per recuperare la pagina successiva dei messaggi. Se questo campo è vuoto, non ci sono 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 in testo normale.
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.

Annotazioni dello strumento

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