MCP Tools Reference: drivemcp.googleapis.com

टूल: copy_file

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

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

कर्ल अनुरोध 
curl --location 'https://drivemcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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

नई बनाई गई फ़ाइल का टाइटल. अगर यह फ़ील्ड खाली है, तो टाइटल '[ओरिजनल फ़ाइल का टाइटल] की कॉपी' होगा.

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

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

टाइमस्टैम्प

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

टूल एनोटेशन

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

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file