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' \
--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
}'

สคีมาอินพุต

ข้อความคำขอสำหรับ 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
}
ช่อง
labelId

string

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

string

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

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

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