MCP Tools Reference: drivemcp.googleapis.com

टूल: copy_file

Google Drive में मौजूद किसी फ़ाइल को कॉपी करने के लिए, इस टूल को कॉल करें. इस टूल की मदद से, कॉपी की गई फ़ाइल के लिए नया टाइटल और पैरंट फ़ोल्डर तय किया जा सकता है. अगर टाइटल तय नहीं किया जाता है, तो कॉपी की गई फ़ाइल का टाइटल 'Copy of {original title}' होगा. अगर पैरंट फ़ोल्डर तय नहीं किया जाता है, तो कॉपी की गई फ़ाइल उसी फ़ोल्डर में बनेगी जिसमें ओरिजनल फ़ाइल है. हालांकि, अगर अनुरोध करने वाले उपयोगकर्ता के पास उस फ़ोल्डर में बदलाव करने की अनुमति नहीं है, तो कॉपी की गई फ़ाइल, उपयोगकर्ता के रूट फ़ोल्डर में बनेगी. कॉपी करने की प्रोसेस पूरी होने पर, नई बनाई गई फ़ाइल का ऑब्जेक्ट दिखता है.

यहां दिए गए सैंपल में, copy_file MCP टूल को कॉल करने के लिए, curl का इस्तेमाल करने का तरीका बताया गया है.

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

इनपुट स्कीमा

किसी फ़ाइल को कॉपी करने का अनुरोध.

CopyFileRequest

JSON के काेड में दिखाना 
{
  "fileId": string,

  "title": string

  "parentId": string
}
फ़ील्ड
fileId

string

ज़रूरी है. कॉपी की जाने वाली फ़ाइल का आईडी.

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

_title की वैल्यू इनमें से कोई एक हो सकती है:
title

string

नई बनाई गई फ़ाइल का टाइटल. अगर यह फ़ील्ड खाली है, तो टाइटल 'Copy of [original file title]' होगा.

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

_parent_id की वैल्यू इनमें से कोई एक हो सकती है:
parentId

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

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

टाइमस्टैम्प

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 और 999,999,999 के बीच होनी चाहिए. इसमें ये दोनों वैल्यू भी शामिल हैं.

टूल के एनोटेशन

डिस्ट्रक्टिव हिंट: ❌ | आइडमपोटेंट हिंट: ❌ | रीड-ओनली हिंट: ❌ | ओपन वर्ल्ड हिंट: ✅