MCP Tools Reference: drivemcp.googleapis.com

Strumento: create_file

Chiama questo strumento per creare o caricare un file su Google Drive.

Se carichi un file, i contenuti devono essere codificati in base64 nel campo content, indipendentemente dal tipo MIME del file caricato.

Restituisce un singolo oggetto File in caso di creazione riuscita.

I seguenti tipi MIME proprietari di Google Drive possono essere creati senza fornire contenuti:

  • application/vnd.google-apps.document
  • application/vnd.google-apps.spreadsheet
  • application/vnd.google-apps.presentation

Per impostazione predefinita, verranno eseguite le seguenti conversioni per i seguenti tipi MIME:

  • Da text/plain a application/vnd.google-apps.document
  • Da text/csv a application/vnd.google-apps.spreadsheet

Per disattivare le conversioni per i tipi MIME proprietari, imposta disable_conversion_to_google_type su true.

Le cartelle possono essere create impostando il tipo MIME su application/vnd.google-apps.folder.

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

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

Schema di input

Richiedi di caricare un file.

CreateFileRequest

Rappresentazione JSON 
{
  "title": string,
  "mimeType": string,
  "content": string,
  "parentId": string,
  "disableConversionToGoogleType": boolean
}
Campi
title

string

Il titolo del file.
mimeType

string

Il tipo MIME del file da caricare.
content

string

I contenuti del file codificati in base64. Il campo dei contenuti deve sempre essere codificato in base64, indipendentemente dal tipo MIME del file.
parentId

string

L'ID principale del file.
disableConversionToGoogleType

boolean

Se è impostato su true, il file non verrà convertito in un tipo Google. Non ha effetto per i tipi MIME che non hanno un equivalente Google.

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
}
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.

Timestamp

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

string (int64 format)

Rappresenta i secondi di tempo UTC dall'epoca di 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: ✅