MCP Tools Reference: drivemcp.googleapis.com

Strumento: create_file

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

Se carichi contenuti, preferisci "text_content" per i contenuti di testo. Per i contenuti non UTF-8, utilizza il campo "base64_content" e codifica i dati in base64 da impostare in questo campo.

Restituisce un singolo oggetto File dopo la creazione.

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

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

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

Quando carichi contenuti, il campo content_mime_type è obbligatorio e deve corrispondere al tipo di contenuti caricati.

Per impostazione predefinita, i contenuti supportati verranno convertiti in tipi MIME proprietari di Google.

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

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP create_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": "create_file",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Richiesta di caricamento di un file.

CreateFileRequest

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

string

Il titolo del file.
mimeType

string

OBSOLETO. NON UTILIZZARE!! Imposta invece content_mime_type.
contentMimeType

string

Il tipo MIME dei contenuti caricati. Obbligatorio quando viene fornito qualsiasi tipo di contenuto.
content

string

I contenuti del file codificati in base64. Il campo dei contenuti deve essere sempre codificato in base64, indipendentemente dal tipo MIME del file. OBSOLETO. Utilizza invece base64_content o text_content.
base64Content

string

Facoltativo. I contenuti codificati in base64 da caricare. È un errore impostare questo campo e text_content.
textContent

string

Facoltativo. I contenuti di testo (UTF-8) da caricare. È un errore impostare questo campo e base64_content.
parentId

string

L'ID principale del file.
disableConversionToGoogleType

boolean

Imposta su true per conservare il tipo MIME dei contenuti passati e non convertirlo in un tipo Google. Ad esempio, senza questa impostazione, un tipo MIME dei contenuti text/plain verrà convertito in application/vnd.google-apps.document. Non ha effetto sui tipi 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

  "canAddChildren": boolean
}
Campi
id

string

L'ID del file recuperato.
title

string

Il titolo del file.
parentId

string

L'ID (facoltativo) del file principale.

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, dove l'output generato sarà sempre normalizzato in base al fuso orario Z e utilizzerà 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, dove l'output generato sarà sempre normalizzato in base al fuso orario Z e utilizzerà 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, dove l'output generato sarà sempre normalizzato in base al fuso orario Z e utilizzerà 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, dove l'output generato sarà sempre normalizzato in base al fuso orario Z e utilizzerà 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. Deve essere compreso tra -62135596800 e 253402300799 inclusi (che corrispondono 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. 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