MCP Tools Reference: gmailmcp.googleapis.com

เครื่องมือ: list_labels

แสดงรายการป้ายกำกับทั้งหมดที่ผู้ใช้กำหนดซึ่งมีอยู่ในบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ ใช้เครื่องมือนี้เพื่อค้นหา id ของป้ายกำกับผู้ใช้ก่อนเรียก label_thread, unlabel_thread, label_message หรือ unlabel_message เครื่องมือนี้จะไม่แสดงป้ายกำกับของระบบ แต่สามารถใช้กับรหัสที่รู้จักกันดีได้ ได้แก่ "INBOX", "TRASH", "SPAM", "STARRED", "UNREAD", "IMPORTANT", "CHAT", "DRAFT" และ "SENT"

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ list_labels MCP

คำขอ 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
}'

สคีมาอินพุต

ข้อความคำขอสำหรับ RPC ของ ListLabels

ListLabelsRequest

การแสดง JSON 
{

  "pageSize": integer

  "pageToken": string
}
ช่อง

ฟิลด์ Union _page_size

_page_size ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
pageSize

integer

ไม่บังคับ จำนวนป้ายกำกับสูงสุดที่จะแสดง

ฟิลด์ Union _page_token

_page_token ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บเพื่อดึงข้อมูลหน้าผลลัพธ์ที่เฉพาะเจาะจงในรายการ

สคีมาเอาต์พุต

ข้อความตอบกลับสำหรับ RPC ของ ListLabels

ListLabelsResponse

การแสดง JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
ช่อง
labels[]

object (Label)

รายการป้ายกำกับของผู้ใช้ในบัญชีของผู้ใช้
nextPageToken

string

โทเค็นเพื่อดึงข้อมูลผลลัพธ์หน้าถัดไปในรายการ

ป้ายกำกับ

การแสดง JSON 
{
  "labelId": string,
  "name": string,
  "color": {
    object (LabelColor)
  },

  "threadsTotal": integer

  "threadsUnread": integer
}
ช่อง
labelId

string

ตัวระบุที่ไม่ซ้ำกันของป้ายกำกับ
name

string

ชื่อที่แสดงของป้ายกำกับที่มนุษย์อ่านได้
color

object (LabelColor)

ไม่บังคับ สีของป้ายกำกับ

ฟิลด์ Union _threads_total

_threads_total ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
threadsTotal

integer

จำนวนเธรดทั้งหมดภายใต้ป้ายกำกับ

ฟิลด์ Union _threads_unread

_threads_unread ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
threadsUnread

integer

จำนวนชุดข้อความที่ยังไม่อ่านภายใต้ป้ายกำกับ

LabelColor

การแสดง JSON 
{
  "textColor": string,
  "backgroundColor": string
}
ช่อง
textColor

string

สีข้อความของป้ายกำกับ ซึ่งแสดงเป็นสตริงเลขฐานสิบหก (เช่น "#000000") อนุญาตให้ใช้ค่าสีที่กำหนดไว้ล่วงหน้าต่อไปนี้เท่านั้น #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

สีพื้นหลังของป้ายกำกับ ซึ่งแสดงเป็นสตริงเลขฐานสิบหก (เช่น "#ffffff") อนุญาตให้ใช้ค่าสีที่กำหนดไว้ล่วงหน้าต่อไปนี้เท่านั้น #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

คำอธิบายประกอบเครื่องมือ

คำแนะนำที่ทำลายล้าง: ❌ | คำแนะนำที่ทำซ้ำได้: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบโลกเปิด: ❌

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • 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