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 viene specificato, il titolo della copia sarà "Copia di {titolo originale}". Se la cartella principale non viene specificata, la copia verrà creata nella stessa cartella del file originale, a meno che l'utente richiedente non abbia accesso in scrittura a quella cartella, nel qual caso la copia verrà creata nella cartella principale dell'utente.Restituisce l'oggetto File appena creato dopo la copia.

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

Richiesta curl 
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
}'

Schema di input

Richiesta di 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) dell'elemento principale 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, compilata 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'ora più recente 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 elementi secondari a questa cartella. Questo valore è sempre false per i tipi non di cartella.

Timestamp

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

string (int64 format)

Rappresenta i secondi dell'ora UTC dall'epoca Unix 1970-01-01T00:00:00Z. Il valore deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

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

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento Open World: ✅

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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