MCP Tools Reference: drivemcp.googleapis.com

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

เรียกใช้เครื่องมือนี้เพื่อค้นหาข้อมูลเมตาทั่วไปเกี่ยวกับไฟล์ในไดรฟ์ของผู้ใช้

หากไม่พบไฟล์ ให้ลองใช้เครื่องมืออื่นๆ เช่น search_files เพื่อค้นหาไฟล์ที่ผู้ใช้ขอ

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

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

สคีมาอินพุต

คำขอรับไฟล์

GetFileRequest

การแสดง JSON 
{
  "fileId": string,

  "excludeContentSnippets": boolean
}
ช่อง
fileId

string

ต้องระบุ รหัสของไฟล์ที่จะดึงข้อมูล

ฟิลด์ Union _exclude_content_snippets

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

boolean

หากเป็นจริง ระบบจะไม่รวมข้อมูลสรุปเนื้อหาไว้ในคำตอบ

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

ทรัพยากรไฟล์

File

การแสดง JSON 
{
  "id": string,
  "title": string,
  "parentId": string,

  "mimeType": string

  "fileSize": string

  "description": string

  "fileExtension": string

  "contentSnippet": string

  "viewUrl": string

  "sharedWithMeTime": string

  "createdTime": string

  "modifiedTime": string

  "viewedByMeTime": string

  "owner": string

  "canAddChildren": boolean
}
ช่อง
id

string

รหัสของไฟล์ที่ดึงข้อมูล
title

string

ชื่อของไฟล์
parentId

string

รหัส (ไม่บังคับ) ของไฟล์ระดับบนของไฟล์

ฟิลด์ Union _mime_type

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

string

ประเภท MIME ของไฟล์

ฟิลด์ Union _file_size

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

string (int64 format)

ขนาดของไฟล์ในหน่วยไบต์

ฟิลด์ Union _description

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

string

คำอธิบายของไฟล์

ฟิลด์ Union _file_extension

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

string

นามสกุลไฟล์เดิมของไฟล์ ซึ่งจะแสดงเฉพาะไฟล์ที่มีเนื้อหาจัดเก็บไว้ในไดรฟ์

ฟิลด์ Union _content_snippet

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

string

ข้อมูลสรุปที่สร้างขึ้นเกี่ยวกับเนื้อหาของไฟล์

ฟิลด์ Union _view_url

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

string

URL สำหรับดูไฟล์

ฟิลด์ Union _shared_with_me_time

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

string (Timestamp format)

เวลาที่แชร์ไฟล์กับผู้ขอ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ฟิลด์ Union _created_time

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

string (Timestamp format)

เวลาที่สร้างไฟล์

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ฟิลด์ Union _modified_time

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

string (Timestamp format)

เวลาล่าสุดที่แก้ไขไฟล์

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ฟิลด์ Union _viewed_by_me_time

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

string (Timestamp format)

เวลาล่าสุดที่ผู้ขอได้ดูไฟล์

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

ฟิลด์ Union _owner

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

string

อีเมลของเจ้าของไฟล์

ฟิลด์ Union _can_add_children

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

boolean

ระบุว่าผู้ขอเพิ่มไฟล์ระดับล่างลงในโฟลเดอร์นี้ได้หรือไม่ ค่าจะเป็น "เท็จ" เสมอสำหรับไฟล์ประเภทที่ไม่ใช่โฟลเดอร์

การประทับเวลา

การแสดง JSON 
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง -62135596800 ถึง 253402300799 (รวม) ซึ่งสอดคล้องกับ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z
nanos

integer

เศษส่วนที่ไม่เป็นค่าลบของวินาทีที่ความละเอียดระดับนาโนวินาที ช่องนี้เป็นส่วนนาโนวินาทีของระยะเวลา ไม่ใช่ทางเลือกแทนวินาที ค่าวินาทีที่เป็นค่าลบซึ่งมีเศษส่วนจะต้องมีค่านาโนวินาทีที่ไม่เป็นค่าลบซึ่งนับไปข้างหน้าในเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 (รวม)

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

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