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 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' \
--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 MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

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

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
}
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.

Chú giải công cụ

Gợi ý mang tính phá hoại: ❌ | Gợi ý mang tính luỹ đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌