MCP Tools Reference: drivemcp.googleapis.com

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

ค้นหาไฟล์ในไดรฟ์โดยใช้การค้นหาที่มีโครงสร้าง (ไวยากรณ์: query_term operator values) รวมประโยคย่อยด้วย and, or, not และวงเล็บ ค่าสตริงต้องอยู่ในเครื่องหมายคำพูดเดี่ยว และต้องหลีกเครื่องหมายคำพูดที่ฝังไว้เป็น \'

คำค้นหาและโอเปอเรเตอร์:

  • title (ops: contains, =, !=) — ชื่อไฟล์
  • fullText (ops: contains) — title or body text
  • mimeType (ops: contains, =, !=) — ประเภท MIME
  • modifiedTime, viewedByMeTime, createdTime (ops: <=, <, =, !=, >, >=) ใช้ UTC ตาม RFC 3339 เช่น 2012-06-04T12:00:00-08:00 ไม่สามารถเปรียบเทียบประเภทวันที่ได้
  • parentId (ops: =, !=) ใช้ 'root' สำหรับ "ไดรฟ์ของฉัน" ของผู้ใช้
  • owner (เจ้าหน้าที่ฝ่ายปฏิบัติการ: =, !=) ใช้ 'me' สำหรับผู้ใช้ที่ขอ
  • sharedWithMe (ops: =, !=) ค่า: true หรือ false

โอเปอเรเตอร์อื่นๆ: and, or, not

ตัวอย่าง

  • title contains 'hello' and title contains 'goodbye'
  • modifiedTime > '2024-01-01T00:00:00Z' and (mimeType contains 'image/' or mimeType contains 'video/')
  • parentId = '1234567'
  • fullText contains 'hello'
  • owner = 'test@example.org'
  • sharedWithMe = true
  • owner = 'me' (สำหรับไฟล์ที่ผู้ใช้เป็นเจ้าของ)

ใช้ next_page_token เพื่อแบ่งหน้า การตอบกลับที่ว่างเปล่าหมายความว่าไม่มีผลการค้นหาเพิ่มเติม

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

คำขอ Curl 
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": "search_files",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

ขอสิทธิ์ค้นหาไฟล์

SearchFilesRequest

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

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
ช่อง
query

string

คำค้นหา

ฟิลด์ Union _page_token

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

string

โทเค็นหน้าเว็บที่จะใช้สำหรับการแบ่งหน้า

ฟิลด์ Union _page_size

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

integer

จำนวนไฟล์สูงสุดที่จะแสดงในแต่ละหน้า

ฟิลด์ Union _exclude_content_snippets

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

boolean

หากเป็นจริง ระบบจะยกเว้นข้อมูลโค้ดเนื้อหาจากคำตอบ

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

การตอบกลับไฟล์ค้นหา

SearchFilesResponse

การแสดง JSON 
{
  "files": [
    {
      object (File)
    }
  ],

  "nextPageToken": string
}
ช่อง
files[]

object (File)

เอาต์พุตเท่านั้น รายการไฟล์

ฟิลด์ Union _next_page_token

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

string

โทเค็นหน้าถัดไป

ไฟล์

การแสดง 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 เท่านั้น

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

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