MCP Tools Reference: gmailmcp.googleapis.com

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

เพิ่มป้ายกำกับให้กับทั้งชุดข้อความในบัญชี Gmail ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ การดำเนินการนี้จะส่งผลต่อข้อความทั้งหมดในชุดข้อความในปัจจุบันและข้อความในอนาคตที่เพิ่มลงในชุดข้อความ

หากไม่แน่ใจเกี่ยวกับรหัสเธรด ให้ใช้เครื่องมือ search_threads ก่อน

หากไม่แน่ใจเกี่ยวกับรหัสของป้ายกำกับผู้ใช้ ให้ใช้list_labelsเครื่องมือก่อนเพื่อค้นหาป้ายกำกับที่มีอยู่และรหัสของป้ายกำกับเหล่านั้น หากต้องการเพิ่มป้ายกำกับถังขยะหรือป้ายกำกับจดหมายขยะในเธรด โปรดใช้เครื่องมือ apply_sensitive_thread_label แทน

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ label_thread 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": "label_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

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

LabelThreadRequest

การแสดง JSON 
{
  "threadId": string,
  "labelIds": [
    string
  ]
}
ช่อง
threadId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันของเธรดที่จะเพิ่มป้ายกำกับ
labelIds[]

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันของป้ายกำกับที่จะเพิ่ม อาจเป็นรหัสป้ายกำกับของระบบ (เช่น "INBOX" "STARRED" "UNREAD" "IMPORTANT") หรือรหัสป้ายกำกับที่ผู้ใช้กำหนด เครื่องมือนี้ยอมรับ label_ids แต่ไม่ยอมรับชื่อค่ายเพลง ใช้เครื่องมือ list_labels เพื่อรับรหัสป้ายกำกับที่เกี่ยวข้องกับชื่อที่แสดงสำหรับป้ายกำกับที่ผู้ใช้กำหนด

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

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

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

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

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

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

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