MCP Tools Reference: drivemcp.googleapis.com

Strumento: copy_file

Chiama questo strumento per copiare un file esistente in Google Drive. Lo strumento consente di specificare un nuovo titolo e una cartella principale per la copia. Se il titolo non è specificato, il titolo della copia sarà "Copia di {titolo originale}". Se la cartella principale non è specificata, la copia verrà creata nella stessa cartella del file originale, a meno che l'utente richiedente non disponga dell'accesso in scrittura a quella cartella, nel qual caso la copia verrà creata nella cartella principale dell'utente. Restituisce l'oggetto File appena creato in caso di copia riuscita.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP copy_file.

Curl Request 
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
}'

Schema di input

Richiedere la copia di un file.

CopyFileRequest

Rappresentazione JSON 
{
  "fileId": string,

  "title": string

  "parentId": string
}
Campi
fileId

string

Obbligatorio. L'ID del file da copiare.

Campo unione _title.

_title può essere solo uno dei seguenti tipi:
title

string

Il titolo del file appena creato. Se è vuoto, il titolo sarà "Copia di [titolo del file originale]".

Campo unione _parent_id.

_parent_id può essere solo uno dei seguenti tipi:
parentId

string

L'ID principale del file appena creato. Se è vuoto, il file verrà creato con lo stesso elemento principale del file originale.

Schema di output

Una risorsa file.

File

Rappresentazione 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
}
Campi
id

string

L'ID del file recuperato.
title

string

Il titolo del file.
parentId

string

L'ID (facoltativo) del genitore del file.

Campo unione _mime_type.

_mime_type può essere solo uno dei seguenti tipi:
mimeType

string

Il tipo MIME del file.

Campo unione _file_size.

_file_size può essere solo uno dei seguenti tipi:
fileSize

string (int64 format)

Le dimensioni del file in byte.

Campo unione _description.

_description può essere solo uno dei seguenti tipi:
description

string

La descrizione del file.

Campo unione _file_extension.

_file_extension può essere solo uno dei seguenti tipi:
fileExtension

string

L'estensione del file originale, questo campo viene compilato solo per i file con contenuti archiviati su Drive.

Campo unione _content_snippet.

_content_snippet può essere solo uno dei seguenti tipi:
contentSnippet

string

Snippet generato sui contenuti del file.

Campo unione _view_url.

_view_url può essere solo uno dei seguenti tipi:
viewUrl

string

L'URL per visualizzare il file.

Campo unione _shared_with_me_time.

_shared_with_me_time può essere solo uno dei seguenti tipi:
sharedWithMeTime

string (Timestamp format)

L'ora in cui il file è stato condiviso con il richiedente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Campo unione _created_time.

_created_time può essere solo uno dei seguenti tipi:
createdTime

string (Timestamp format)

L'ora in cui è stato creato il file.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Campo unione _modified_time.

_modified_time può essere solo uno dei seguenti tipi:
modifiedTime

string (Timestamp format)

L'ora più recente in cui il file è stato modificato.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Campo unione _viewed_by_me_time.

_viewed_by_me_time può essere solo uno dei seguenti tipi:
viewedByMeTime

string (Timestamp format)

L'ultima volta in cui il file è stato visualizzato dal richiedente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

Campo unione _owner.

_owner può essere solo uno dei seguenti tipi:
owner

string

L'indirizzo email del proprietario del file.

Campo unione _can_add_children.

_can_add_children può essere solo uno dei seguenti tipi:
canAddChildren

boolean

Indica se il richiedente può aggiungere figli a questa cartella. Questo valore è sempre false per i tipi non cartella.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi del tempo UTC a partire dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la porzione di nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ✅