MCP Tools Reference: drivemcp.googleapis.com

टूल: search_files

स्ट्रक्चर्ड क्वेरी (सिंटैक्स: query_term operator values) का इस्तेमाल करके, Drive में मौजूद फ़ाइलें खोजें. क्लॉज़ को and, or, not, और कोष्ठकों के साथ मिलाएं. स्ट्रिंग वैल्यू को सिंगल कोट में रखना ज़रूरी है. एम्बेड किए गए कोट को \' के तौर पर एस्केप करें.

क्वेरी के लिए इस्तेमाल किए गए शब्द और ऑपरेटर:

  • title (ops: contains, =, !=) — फ़ाइल का टाइटल
  • fullText (ops: contains) — टाइटल या मुख्य हिस्से का टेक्स्ट
  • mimeType (ops: contains, =, !=) — MIME टाइप
  • modifiedTime, viewedByMeTime, createdTime (ops: <=, <, =, !=, >, >=). RFC 3339 UTC का इस्तेमाल करें. उदाहरण के लिए, 2012-06-04T12:00:00-08:00. तारीख के टाइप की तुलना नहीं की जा सकती.
  • parentId (ops: =, !=). उपयोगकर्ता की "मेरी ड्राइव" के लिए 'root' का इस्तेमाल करें.
  • owner (ऑपरेशन: =, !=). अनुरोध करने वाले उपयोगकर्ता के लिए 'me' का इस्तेमाल करें.
  • sharedWithMe (ऑपरेटर: =, !=). वैल्यू: 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 एमसीपी टूल को शुरू करने का तरीका बताया गया है.

कर्ल अनुरोध 
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

सर्च क्वेरी.

यूनियन फ़ील्ड _page_token.

_page_token इनमें से सिर्फ़ एक हो सकता है:
pageToken

string

पेज नंबर के हिसाब से नतीजे दिखाने के लिए इस्तेमाल किया जाने वाला पेज टोकन.

यूनियन फ़ील्ड _page_size.

_page_size इनमें से सिर्फ़ एक हो सकता है:
pageSize

integer

हर पेज में ज़्यादा से ज़्यादा फ़ाइलें दिखाने की संख्या.

यूनियन फ़ील्ड _exclude_content_snippets.

_exclude_content_snippets इनमें से सिर्फ़ एक हो सकता है:
excludeContentSnippets

boolean

अगर यह वैल्यू सही है, तो कॉन्टेंट स्निपेट को जवाब में शामिल नहीं किया जाएगा.

आउटपुट स्कीमा

फ़ाइलें खोजने के लिए जवाब.

SearchFilesResponse

JSON के काेड में दिखाना 
{
  "files": [
    {
      object (File)
    }
  ],

  "nextPageToken": string
}
फ़ील्ड
files[]

object (File)

सिर्फ़ आउटपुट के लिए. फ़ाइलों की सूची.

यूनियन फ़ील्ड _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

फ़ाइल के पैरंट का आईडी (ज़रूरी नहीं).

यूनियन फ़ील्ड _mime_type.

_mime_type इनमें से सिर्फ़ एक हो सकता है:
mimeType

string

फ़ाइल का MIME टाइप.

यूनियन फ़ील्ड _file_size.

_file_size इनमें से सिर्फ़ एक हो सकता है:
fileSize

string (int64 format)

फ़ाइल का साइज़, बाइट में.

यूनियन फ़ील्ड _description.

_description इनमें से सिर्फ़ एक हो सकता है:
description

string

फ़ाइल के बारे में जानकारी.

यूनियन फ़ील्ड _file_extension.

_file_extension इनमें से सिर्फ़ एक हो सकता है:
fileExtension

string

फ़ाइल का ओरिजनल फ़ाइल एक्सटेंशन. यह सिर्फ़ उन फ़ाइलों के लिए भरा जाता है जिनका कॉन्टेंट Drive में सेव किया गया है.

यूनियन फ़ील्ड _content_snippet.

_content_snippet इनमें से सिर्फ़ एक हो सकता है:
contentSnippet

string

फ़ाइल के कॉन्टेंट के बारे में जनरेट किया गया स्निपेट.

यूनियन फ़ील्ड _view_url.

_view_url इनमें से सिर्फ़ एक हो सकता है:
viewUrl

string

फ़ाइल देखने का यूआरएल.

यूनियन फ़ील्ड _shared_with_me_time.

_shared_with_me_time इनमें से सिर्फ़ एक हो सकता है:
sharedWithMeTime

string (Timestamp format)

फ़ाइल को अनुरोध करने वाले व्यक्ति के साथ शेयर किए जाने का समय.

यह आरएफ़सी 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".

यूनियन फ़ील्ड _created_time.

_created_time इनमें से सिर्फ़ एक हो सकता है:
createdTime

string (Timestamp format)

वह समय जब फ़ाइल बनाई गई थी.

यह आरएफ़सी 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".

यूनियन फ़ील्ड _modified_time.

_modified_time इनमें से सिर्फ़ एक हो सकता है:
modifiedTime

string (Timestamp format)

फ़ाइल में आखिरी बार बदलाव कब किया गया था.

यह आरएफ़सी 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".

यूनियन फ़ील्ड _viewed_by_me_time.

_viewed_by_me_time इनमें से सिर्फ़ एक हो सकता है:
viewedByMeTime

string (Timestamp format)

अनुरोध करने वाले व्यक्ति ने फ़ाइल को पिछली बार कब देखा था.

यह आरएफ़सी 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".

यूनियन फ़ील्ड _owner.

_owner इनमें से सिर्फ़ एक हो सकता है:
owner

string

फ़ाइल के मालिक का ईमेल पता.

यूनियन फ़ील्ड _can_add_children.

_can_add_children इनमें से सिर्फ़ एक हो सकता है:
canAddChildren

boolean

अनुरोध करने वाला व्यक्ति, इस फ़ोल्डर में बच्चों को जोड़ सकता है या नहीं. फ़ोल्डर के अलावा अन्य टाइप के लिए, यह हमेशा गलत होता है.

टाइमस्टैम्प

JSON के काेड में दिखाना 
{
  "seconds": string,
  "nanos": integer
}
फ़ील्ड
seconds

string (int64 format)

यह Unix epoch 1970-01-01T00:00:00Z के बाद से यूटीसी समय के सेकंड को दिखाता है. यह -62135596800 और 253402300799 के बीच होना चाहिए. इसमें ये दोनों वैल्यू भी शामिल हैं. यह 0001-01-01T00:00:00Z से 9999-12-31T23:59:59Z के बीच की वैल्यू के बराबर होता है.
nanos

integer

नैनोसेकंड रिज़ॉल्यूशन पर, सेकंड के नॉन-नेगेटिव फ़्रैक्शन. यह फ़ील्ड, अवधि का नैनोसेकंड वाला हिस्सा है. यह सेकंड का विकल्प नहीं है. भिन्नात्मक वैल्यू वाली नेगेटिव सेकंड वैल्यू में, नैनोसेकंड की नॉन-नेगेटिव वैल्यू होनी चाहिए. यह 0 और 99,99,99,999 के बीच होना चाहिए.

टूल एनोटेशन

बदलाव करने से जुड़ी जानकारी: ❌ | एक ही बार लागू होने से जुड़ी जानकारी: ✅ | सिर्फ़ पढ़ने से जुड़ी जानकारी: ✅ | ओपन वर्ल्ड से जुड़ी जानकारी: ❌