MCP Tools Reference: gmailmcp.googleapis.com

Công cụ: list_labels

Liệt kê tất cả nhãn do người dùng xác định có trong tài khoản Gmail của người dùng đã xác thực. Hãy sử dụng công cụ này để khám phá id của nhãn người dùng trước khi gọi label_thread, unlabel_thread, label_message hoặc unlabel_message. Công cụ này không trả về nhãn hệ thống nhưng bạn có thể sử dụng nhãn hệ thống bằng các mã nhận dạng đã biết: "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT", "SENT".

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ list_labels 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": "list_labels",
    "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 ListLabels RPC.

ListLabelsRequest

Biểu diễn dưới dạng JSON 
{

  "pageSize": integer

  "pageToken": string
}
Trường

Trường nhóm _page_size.

_page_size chỉ có thể là một trong những trạng thái sau:
pageSize

integer

Không bắt buộc. Số lượng nhãn tối đa cần trả về.

Trường nhóm _page_token.

_page_token chỉ có thể là một trong những trạng thái sau:
pageToken

string

Không bắt buộc. Mã thông báo trang để truy xuất một trang kết quả cụ thể trong danh sách.

Giản đồ đầu ra

Thông báo phản hồi cho RPC ListLabels.

ListLabelsResponse

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

object (Label)

Danh sách nhãn người dùng trong tài khoản của người dùng.
nextPageToken

string

Mã thông báo để truy xuất trang kết quả tiếp theo trong danh sách.

Hãng nhạc

Biểu diễn dưới dạng JSON 
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
Trường
labelId

string

Giá trị nhận dạng duy nhất của nhãn.
name

string

Tên hiển thị dễ đọc của nhãn.
color

object (LabelColor)

Không bắt buộc. Màu của nhãn.

Trường nhóm _threads_total.

_threads_total chỉ có thể là một trong những trạng thái sau:
threadsTotal

integer

Tổng số chuỗi thư có nhãn này.

Trường nhóm _threads_unread.

_threads_unread chỉ có thể là một trong những trạng thái sau:
threadsUnread

integer

Số lượng chuỗi tin nhắn chưa đọc trong nhãn.

LabelColor

Biểu diễn dưới dạng JSON 
{
  "textColor": string,
  "backgroundColor": string
}
Trường
textColor

string

Màu văn bản của nhãn, được biểu thị dưới dạng một chuỗi thập lục phân (ví dụ: "#000000").
backgroundColor

string

Màu nền của nhãn, được biểu thị dưới dạng một chuỗi thập lục phân (ví dụ: "#ffffff").

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