MCP Tools Reference: gmailmcp.googleapis.com

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

เวอร์ชันตัวอย่างสำหรับนักพัฒนาซอฟต์แวร์: พร้อมให้บริการในโปรแกรมทดลองใช้สำหรับนักพัฒนาแอปของ Google Workspace ซึ่งให้สิทธิ์ทดลองใช้ฟีเจอร์บางอย่างก่อนเปิดตัว

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

พารามิเตอร์ messageFormat (ไม่บังคับ) จะควบคุมรูปแบบของข้อความที่แสดง โดยค่าเริ่มต้น (หรือใช้ FULL_CONTENT) จะแสดงเนื้อหาทั้งหมดของข้อความ ใช้ MINIMAL เพื่อรวมเฉพาะเรื่องและข้อมูลโค้ด (ไม่รวมเนื้อหา) ใช้ METADATA_ONLY เพื่อรวมเฉพาะข้อมูลเมตาพื้นฐาน (รหัสข้อความ รหัสเธรด ป้ายกำกับการประทับเวลา และการประมาณขนาด)

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ get_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": "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 หมายเหตุ: รูปแบบ MINIMAL จะแสดงผลรหัส ข้อมูลโค้ด เรื่อง จาก ถึง สำเนา วันที่ และ labelIds รูปแบบ METADATA_ONLY จะแสดงผลรหัส จาก ถึง สำเนา วันที่ และ labelIds FULL_CONTENT จะแสดงผลรหัส ข้อมูลโค้ด เรื่อง จาก ถึง สำเนา วันที่ labelIds, attachmentIds, plaintextBody, htmlBody และสิ่งที่แนบมา

MessageFormat

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

Enum
MESSAGE_FORMAT_UNSPECIFIED	ค่าเริ่มต้นคือ FULL_CONTENT
MINIMAL	แสดงตัวอย่างข้อความและส่วนหัวที่สำคัญ (เรื่อง จาก ถึง สำเนา วันที่)
FULL_CONTENT	แสดงข้อมูลทั้งหมดใน "MINIMAL" พร้อมเนื้อหาแบบเต็มของแต่ละข้อความ
METADATA_ONLY	ข้อมูลเมตาเท่านั้น: ไม่รวมหัวเรื่อง ตัวอย่าง เนื้อหา และชื่อไฟล์แนบ

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

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

ชุดข้อความ

การแสดง 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 ], "htmlBody": string, "attachments": [ { object (AttachmentMetadata) } ], "labelIds": [ 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 เท่านั้น
htmlBody	string เนื้อหา HTML ของอีเมล จะแสดงก็ต่อเมื่อ MessageFormat เป็น FULL_CONTENT
attachments[]	object (AttachmentMetadata) เอาต์พุตเท่านั้น ไฟล์แนบจะแสดงก็ต่อเมื่อ MessageFormat เป็น FULL_CONTENT เท่านั้น
labelIds[]	string รหัสของป้ายกำกับที่แนบกับข้อความ รวมรหัสของป้ายกำกับที่ผู้ใช้สร้างขึ้นและป้ายกำกับของระบบมาตรฐานที่จำกัดไว้สำหรับ INBOX, SPAM, TRASH, UNREAD, STARRED, IMPORTANT, SENT, DRAFT, CHAT

AttachmentMetadata

การแสดง JSON
{ "id": string, "mimeType": string, "filename": string }

ช่อง
id	string เอาต์พุตเท่านั้น รหัสของไฟล์แนบ
mimeType	string ประเภท MIME ของไฟล์แนบ
filename	string ชื่อไฟล์ของไฟล์แนบ

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

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

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

ต้องใช้ขอบเขต 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.metadata