MCP Tools Reference: gmailmcp.googleapis.com

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

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

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

คำขอ Curl 
curl --location 'https://gmailmcp.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_thread",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

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

GetThreadRequest

การแสดง JSON 
{
  "threadId": string,
  "messageFormat": enum (MessageFormat)
}
ช่อง
threadId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันของชุดข้อความที่จะดึงข้อมูล
messageFormat

enum (MessageFormat)

ไม่บังคับ ระบุรูปแบบของข้อความที่แสดงผลภายในชุดข้อความ ค่าเริ่มต้นคือ FULL_CONTENT หมายเหตุ: หากต้องการเนื้อหาหรือไฟล์แนบ ให้ใช้ FULL_CONTENT เมื่อใช้ MINIMAL ระบบจะไม่ป้อนข้อมูลในช่อง plaintext_body และ attachment_ids หากไม่แน่ใจว่าจะใช้รูปแบบใด ให้ใช้ลักษณะการทำงานเริ่มต้นโดยใช้ FULL_CONTENT

MessageFormat

Enum เพื่อควบคุมระดับรายละเอียดของข้อความในชุดข้อความ

Enum
MESSAGE_FORMAT_UNSPECIFIED ค่าเริ่มต้นคือ FULL_CONTENT
MINIMAL แสดงผลข้อมูลสรุปของข้อความและส่วนหัวหลัก (เรื่อง จาก ถึง สำเนา วันที่)
FULL_CONTENT แสดงผลข้อมูลทั้งหมดใน "MINIMAL" รวมถึงเนื้อหาแบบเต็มของแต่ละข้อความ

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

ชุดข้อความที่มีรายการข้อความ

ชุดข้อความ

การแสดง JSON 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
ช่อง
id

string

ตัวระบุที่ไม่ซ้ำกันของชุดข้อความ
messages[]

object (Message)

รายการข้อความในชุดข้อความที่เรียงตามลำดับเวลา

ข้อความ

การแสดง JSON 
{
  "id": string,
  "snippet": string,
  "subject": string,
  "sender": string,
  "toRecipients": [
    string
  ],
  "ccRecipients": [
    string
  ],
  "date": string,
  "plaintextBody": string,
  "attachmentIds": [
    string
  ]
}
ช่อง
id

string

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

string

ข้อมูลสรุปของเนื้อหาข้อความ
subject

string

เรื่องของข้อความที่แยกจากส่วนหัว
sender

string

อีเมลของผู้ส่ง
toRecipients[]

string

อีเมลของผู้รับ
ccRecipients[]

string

อีเมลของผู้รับสำเนา
date

string

วันที่ของข้อความในรูปแบบ ISO 8601 (YYYY-MM-DD)
plaintextBody

string

เนื้อหาแบบเต็ม โดยจะแสดงผลก็ต่อเมื่อ MessageFormat เป็น FULL_CONTENT
attachmentIds[]

string

เอาต์พุตเท่านั้น รหัสไฟล์แนบ โดยจะแสดงผลก็ต่อเมื่อ MessageFormat เป็น FULL_CONTENT

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

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