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 (visibili solo a un singolo utente) vengono filtrati.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP list_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": "list_messages",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Richiedi di elencare i messaggi di una conversazione di Google Chat specifica.

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 una chat/un messaggio diretto di gruppo. 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

Risposta contenente l'elenco dei messaggi della conversazione richiesta.

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 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: ❌