MCP Tools Reference: drivemcp.googleapis.com

Strumento: search_files

Cerca i file di Drive utilizzando una query strutturata (sintassi: query_term operator values). Combina le clausole con and, or, not, e le parentesi. I valori stringa devono essere racchiusi tra virgolette singole; inserisci le virgolette incorporate come \'.

Termini di query e operatori:

  • title (operatori: contains, =, !=) — titolo del file
  • fullText (operatori: contains) — titolo o corpo del testo
  • mimeType (operatori: contains, =, !=) — tipo MIME
  • modifiedTime, viewedByMeTime, createdTime (operatori: <=, <, =, !=, >, >=). Utilizza RFC 3339 UTC, ad es. 2012-06-04T12:00:00-08:00. I tipi di date non sono comparabili.
  • parentId (operatori: =, !=). Utilizza 'root' per "Il mio Drive" dell'utente.
  • owner (operatori: =, !=). Utilizza 'me' per l'utente che effettua la richiesta.
  • sharedWithMe (operatori: =, !=). Valori: true o false.

Altri operatori: and, or, not.

Esempi:

  • title contains 'hello' and title contains 'goodbye'
  • modifiedTime > '2024-01-01T00:00:00Z' and (mimeType contains 'image/' or mimeType contains 'video/')
  • parentId = '1234567'
  • fullText contains 'hello'
  • owner = 'test@example.org'
  • sharedWithMe = true
  • owner = 'me' (per i file di proprietà dell'utente)

Utilizza next_page_token per la paginazione. Una risposta vuota indica che non ci sono altri risultati.

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

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

Schema di input

Richiesta di ricerca dei file.

SearchFilesRequest

Rappresentazione JSON 
{
  "query": string,

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
Campi
query

string

La query di ricerca.

Campo unione _page_token.

_page_token può essere solo uno dei seguenti tipi:
pageToken

string

Il token di pagina da utilizzare per la paginazione.

Campo unione _page_size.

_page_size può essere solo uno dei seguenti tipi:
pageSize

integer

Il numero massimo di file da restituire in ogni pagina.

Campo unione _exclude_content_snippets.

_exclude_content_snippets può essere solo uno dei seguenti tipi:
excludeContentSnippets

boolean

Se è true, lo snippet di contenuti verrà escluso dalla risposta.

Schema di output

Risposta alla ricerca dei file.

SearchFilesResponse

Rappresentazione JSON 
{
  "files": [
    {
      object (File)
    }
  ],

  "nextPageToken": string
}
Campi
files[]

object (File)

Solo output. L'elenco dei file.

Campo unione _next_page_token.

_next_page_token può essere solo uno dei seguenti tipi:
nextPageToken

string

Il token di pagina successiva.

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, 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 figli a questa cartella. Questo valore è sempre false per i tipi non di cartelle.

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 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: ❌