MCP Tools Reference: drivemcp.googleapis.com

टूल: search_files

स्ट्रक्चर्ड क्वेरी के आधार पर Drive में मौजूद फ़ाइलें खोजने के लिए, इस टूल को कॉल करें.

query फ़ील्ड में, क्वेरी सर्च ऑपरेटर का इस्तेमाल करना ज़रूरी है.

क्वेरी स्ट्रिंग में ये तीन हिस्से होते हैं: query_term operator values जहां:

  • query_term क्वेरी टर्म या वह फ़ील्ड है जिसमें खोज करनी है.
  • operator क्वेरी टर्म के लिए शर्त तय करता है.
  • values वे खास वैल्यू हैं जिनका इस्तेमाल करके, खोज के नतीजों को फ़िल्टर किया जा सकता है.

खोज में इस्तेमाल होने वाले शब्द और नाम

यहां दी गई टेबल में, क्वेरी के मान्य शब्दों के साथ-साथ उनके बारे में जानकारी दी गई है:

क्वेरी के लिए इस्तेमाल किया गया शब्द मान्य ऑपरेटर इस्तेमाल
title contains, =, != फ़ाइल का टाइटल. सिंगल कोट (') का इस्तेमाल करें. क्वेरी में सिंगल कोट को \' के साथ एस्केप करें. जैसे, 'Valentine\'s Day'.
fullText contains क्या फ़ाइल के कॉन्टेंट में मौजूद title या टेक्स्ट मेल खाता है. सिंगल कोट (') का इस्तेमाल करें. क्वेरी में सिंगल कोट को \' के साथ एस्केप करें. जैसे, 'Valentine\'s Day'.
mimeType contains, =, != फ़ाइल का MIME टाइप. सिंगल कोट (') का इस्तेमाल करें. क्वेरी में सिंगल कोट को \' के साथ एस्केप करें. जैसे, 'Valentine\'s Day'.
modifiedTime <=, <, =, !=, >, >= फ़ाइल में पिछली बार बदलाव किए जाने की तारीख. आरएफ़सी 3339 फ़ॉर्मैट. डिफ़ॉल्ट टाइम ज़ोन यूटीसी होता है. जैसे, 2012-06-04T12:00:00-08:00. date टाइप के फ़ील्ड की तुलना नहीं की जा सकती.
viewedByMeTime <=, <, =, !=, >, >= वह तारीख जब उपयोगकर्ता ने आखिरी बार कोई फ़ाइल देखी थी. आरएफ़सी 3339 फ़ॉर्मैट. डिफ़ॉल्ट टाइम ज़ोन यूटीसी होता है. जैसे, 2012-06-04T12:00:00-08:00. date टाइप के फ़ील्ड की तुलना नहीं की जा सकती.
parentId =, != क्या पैरंट, तय किए गए आईडी के बराबर है. root का इस्तेमाल, उपयोगकर्ता की "मेरी ड्राइव" को मुख्य हाइरार्की के तौर पर सेट करने के लिए किया जा सकता है.
owner =, != वह उपयोगकर्ता जिसके पास फ़ाइल का मालिकाना हक है. me का इस्तेमाल, अनुरोध करने वाले उपयोगकर्ता के बारे में बताने के लिए किया जा सकता है.
sharedWithMe =, != उपयोगकर्ता के "मुझसे शेयर की गई" कलेक्शन में मौजूद फ़ाइलें. फ़ाइल का इस्तेमाल करने वाले सभी लोग, फ़ाइल की ऐक्सेस कंट्रोल लिस्ट (एसीएल) में शामिल हों. यह true या false हो सकता है.
createdTime <=, <, =, !=, >, >= वह तारीख जब फ़ाइल बनाई गई थी. आरएफ़सी 3339 फ़ॉर्मैट का इस्तेमाल करें. डिफ़ॉल्ट टाइम ज़ोन यूटीसी होता है. जैसे, 2012-06-04T12:00:00-08:00.

क्वेरी ऑपरेटर

यहां दी गई टेबल में, मान्य क्वेरी ऑपरेटर दिए गए हैं:

ऑपरेटर इस्तेमाल
contains एक स्ट्रिंग का कॉन्टेंट, दूसरी स्ट्रिंग में मौजूद है.
= किसी स्ट्रिंग या बूलियन का कॉन्टेंट, दूसरे के बराबर है.
!= स्ट्रिंग या बूलियन का कॉन्टेंट, दूसरे के बराबर नहीं है.
< एक वैल्यू दूसरी वैल्यू से कम है.
<= एक वैल्यू, दूसरी वैल्यू से कम या उसके बराबर है.
> एक वैल्यू, दूसरी वैल्यू से ज़्यादा है.
>= एक वैल्यू, दूसरी वैल्यू से ज़्यादा या उसके बराबर होती है.
in कोई एलिमेंट, किसी कलेक्शन में शामिल होता है.
and दोनों क्वेरी से मेल खाने वाले आइटम दिखाएं.
or ऐसी चीज़ें दिखाओ जो दोनों क्वेरी से मेल खाती हों.
not यह फ़ंक्शन, सर्च क्वेरी को नकारता है.
has कलेक्शन में, पैरामीटर से मेल खाने वाला कोई एलिमेंट मौजूद है.

क्वेरी के कुछ उदाहरण यहां दिए गए हैं:

  • 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 अनुरोध 
curl --location 'https://drivemcp.googleapis.com/mcp' \
--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 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
}
फ़ील्ड
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

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

टाइमस्टैम्प

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 के बीच होना चाहिए.

टूल एनोटेशन

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