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 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ụ MCP list_labels.

Yêu cầu Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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 riêng biệ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 trong nhãn.

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"). Bạn chỉ được phép dùng tập hợp giá trị màu được xác định trước sau đây: #000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c, #464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765
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"). Bạn chỉ được phép dùng tập hợp giá trị màu được xác định trước sau đây: #000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c, #464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765

Chú giải công cụ

Gợi ý phá hoại: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌

Phạm vi cấp phép

Yêu cầu một trong các phạm vi OAuth sau:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.labels
  • https://www.googleapis.com/auth/gmail.metadata