MCP Tools Reference: gmailmcp.googleapis.com

Công cụ: get_thread

Truy xuất một chuỗi email cụ thể từ tài khoản Gmail của người dùng đã xác thực, bao gồm cả danh sách thư của chuỗi đó.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ get_thread MCP.

Yêu cầu Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

Thông báo yêu cầu cho RPC GetThread.

GetThreadRequest

Biểu diễn dưới dạng JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
Trường
threadId

string

Bắt buộc. Giá trị nhận dạng riêng biệt của luồng cần tìm nạp.
messageFormat

enum (MessageFormat)

Không bắt buộc. Chỉ định định dạng của các thông báo được trả về trong luồng. Giá trị mặc định là FULL_CONTENT. Lưu ý: Nếu bạn cần nội dung hoặc tệp đính kèm trong phần nội dung, hãy sử dụng FULL_CONTENT. Khi sử dụng MINIMAL, các trường plaintext_body và attachment_ids sẽ không được điền sẵn. Nếu không chắc nên dùng định dạng nào, hãy dựa vào hành vi mặc định bằng cách sử dụng FULL_CONTENT.

MessageFormat

Liệt kê để kiểm soát mức độ chi tiết của các thông báo trong luồng.

Enum
MESSAGE_FORMAT_UNSPECIFIED Giá trị mặc định là FULL_CONTENT.
MINIMAL Trả về đoạn trích thư và các tiêu đề chính (Tiêu đề, Người gửi, Người nhận, Cc, Ngày).
FULL_CONTENT Trả về tất cả thông tin trong "TỐI THIỂU" cùng với nội dung đầy đủ của từng thư.

Giản đồ đầu ra

Luồng chứa danh sách tin nhắn.

Chuỗi hội thoại

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Trường
id

string

Giá trị nhận dạng duy nhất của luồng.
messages[]

object (Message)

Danh sách các tin nhắn trong chuỗi, được sắp xếp theo thứ tự thời gian.

Nhắn tin

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
Trường
id

string

Giá trị nhận dạng riêng biệt của thông báo.
snippet

string

Đoạn trích nội dung thư.
subject

string

Tiêu đề thư được trích xuất từ phần đầu thư:
sender

string

Địa chỉ email của người gửi.
toRecipients[]

string

Đến địa chỉ email của người nhận.
ccRecipients[]

string

Địa chỉ email của người nhận CC.
date

string

Ngày của thông báo ở định dạng ISO 8601 (YYYY-MM-DD).
plaintextBody

string

Nội dung toàn bộ phần nội dung, chỉ được điền sẵn nếu MessageFormat là FULL_CONTENT.
attachmentIds[]

string

Chỉ có đầu ra. Mã nhận dạng tệp đính kèm, chỉ được điền sẵn nếu MessageFormat là FULL_CONTENT.

Chú giải công cụ

Gợi ý phá huỷ: ❌ | Gợi ý không thay đổi giá trị: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌