MCP Tools Reference: chatmcp.googleapis.com

Narzędzie: send_message

Wysyła wiadomość w Google Chat do rozmowy.

To narzędzie wykorzystuje identyfikator rozmowy, opcjonalny identyfikator wątku i tekst wiadomości jako dane wejściowe. Identyfikatory rozmów można znaleźć za pomocą narzędzia search_conversations. Zwraca utworzoną wiadomość.

Poniższy przykład pokazuje, jak za pomocą znaku curl wywołać narzędzie send_message MCP.

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

Schemat danych wejściowych

Prośba o wysłanie wiadomości w rozmowie w Google Chat.

SendMessageRequest

Zapis JSON 
{
  "conversationId": string,
  "threadId": string,
  "messageText": string
}
Pola
conversationId

string

Wymagane. Identyfikator rozmowy (np. „spaces/AAAA...”), do której ma zostać wysłana wiadomość.
threadId

string

Opcjonalnie. Identyfikator wątku (np. „spaces/AAAA.../threads/BBBB...”), do którego ma zostać wysłana wiadomość. Jeśli nie skonfigurujesz tej zasady, wiadomość zostanie wysłana do nowego wątku.
messageText

string

Wymagane. Główna treść wiadomości. Podstawowe formatowanie można dodać za pomocą podzbioru Markdown. Informacje o formatowaniu wiadomości znajdziesz w artykule Formatowanie wiadomości. Obsługiwane jest to formatowanie:

  • Pogrubienie: *text*
  • Kursywa: _text_
  • Przekreślenie: ~text~
  • Monospace: text
  • Blok o stałej szerokości znaków:
```
line 1
line 2
```
  • Lista punktowana:
* item 1
* item 2
  • Cytat blokowy: > quoted text
  • Hiperlink: <url|display text>
  • Wzmianka o użytkowniku: <users/{user_id}>

Schemat wyjściowy

Odpowiedź na wysłanie wiadomości w rozmowie w Google Chat.

SendMessageResponse

Zapis JSON 
{
  "message": {
    object (ChatMessage)
  }
}
Pola
message

object (ChatMessage)

Wysłana wiadomość.

ChatMessage

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

string

Nazwa zasobu wiadomości. Format: spaces/{space}/messages/{message}
threadId

string

Wątek, do którego należy ta wiadomość. Jeśli wiadomość nie jest częścią wątku, to pole będzie puste. Format: spaces/{space}/threads/{thread}
plaintextBody

string

Treść wiadomości w formacie zwykłego tekstu.
sender

object (User)

Nadawca wiadomości.
createTime

string

Tylko dane wyjściowe. Sygnatura czasowa utworzenia wiadomości.
threadedReply

boolean

Określa, czy wiadomość jest odpowiedzią w wątku.
attachments[]

object (ChatAttachmentMetadata)

Załączniki dołączone do wiadomości.
reactionSummaries[]

object (ReactionSummary)

Podsumowanie reakcji emotikonami zawarte w wiadomości.

Użytkownik

Zapis JSON 
{
  "userId": string,
  "displayName": string,
  "email": string,
  "userType": enum (UserType)
}
Pola
userId

string

Nazwa zasobu użytkownika Google Chat. Format: users/{user}.
displayName

string

Wyświetlana nazwa użytkownika Google Chat.
email

string

Adres e-mail użytkownika. To pole jest wypełniane tylko wtedy, gdy typ użytkownika to HUMAN.
userType

enum (UserType)

Typ użytkownika.

ChatAttachmentMetadata

Zapis JSON 
{
  "attachmentId": string,
  "filename": string,
  "mimeType": string,
  "source": enum (Source)
}
Pola
attachmentId

string

Nazwa zasobu załącznika. Format: spaces/{space}/messages/{message}/attachments/{attachment}.
filename

string

Nazwa załącznika.
mimeType

string

Typ treści (typ MIME).
source

enum (Source)

Źródło załącznika.

ReactionSummary

Zapis JSON 
{
  "emoji": string,
  "count": integer
}
Pola
emoji

string

Ciąg znaków Unicode emotikona lub nazwa niestandardowego emotikona.
count

integer

Łączna liczba reakcji z użyciem powiązanego emotikona.

UserType

Typ użytkownika Google Chat.

Wartości w polu enum
USER_TYPE_UNSPECIFIED Nie określono.
HUMAN Użytkownik.
APP użytkownik aplikacji,

Źródło

Źródło załącznika.

Wartości w polu enum
SOURCE_UNSPECIFIED Zarezerwowano.
DRIVE_FILE Plik pochodzi z Dysku Google.
UPLOADED_CONTENT Plik zostanie przesłany do Google Chat.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ✅