MCP Tools Reference: drivemcp.googleapis.com

Tool: search_files

Rufen Sie dieses Tool auf, um anhand einer strukturierten Anfrage nach Drive-Dateien zu suchen.

Für das Feld query müssen Suchoperatoren für Abfragen verwendet werden.

Ein Abfragestring enthält die folgenden drei Teile: query_term operator values, wobei gilt:

  • query_term ist der Suchbegriff oder das Feld, nach dem gesucht werden soll.
  • operator gibt die Bedingung für den Suchbegriff an.
  • values sind die spezifischen Werte, mit denen Sie Ihre Suchergebnisse filtern können.

Suchbegriffe

In der folgenden Tabelle sind gültige Suchbegriffe mit ihren Beschreibungen aufgeführt:

Suchbegriff Gültige Operatoren Nutzung
title contains, =, != Titel der Datei. In einfache Anführungszeichen (') setzen. Einfache Anführungszeichen in Abfragen mit \' maskieren, z. B. 'Valentine\'s Day'.
fullText contains Gibt an, ob die title oder der Text im Inhalt der Datei übereinstimmen. In einfache Anführungszeichen (') setzen. Einfache Anführungszeichen in Abfragen mit \' maskieren, z. B. 'Valentine\'s Day'.
mimeType contains, =, != MIME-Typ der Datei. In einfache Anführungszeichen (') setzen. Einfache Anführungszeichen in Abfragen mit \' maskieren, z. B. 'Valentine\'s Day'.
modifiedTime <=, <, =, !=, >, >= Datum der letzten Änderung der Datei. RFC 3339-Format, Standardzeitzone ist UTC, z. B. 2012-06-04T12:00:00-08:00. Felder vom Typ date sind nicht vergleichbar.
viewedByMeTime <=, <, =, !=, >, >= Das Datum, an dem der Nutzer eine Datei zuletzt aufgerufen hat. RFC 3339-Format, Standardzeitzone ist UTC, z. B. 2012-06-04T12:00:00-08:00. Felder vom Typ date sind nicht vergleichbar.
parentId =, != Gibt an, ob das übergeordnete Element der angegebenen ID entspricht. Mit root kann die Ablage des Nutzers angegeben werden, die als primäre Hierarchie dient.
owner =, != Nutzer, dem die Datei gehört Mit me kann der Nutzer angegeben werden, der die Anfrage stellt.
sharedWithMe =, != Dateien in der Sammlung „Für mich freigegeben“ des Nutzers. Alle Dateinutzer sind in der Zugriffssteuerungsliste (Access Control List, ACL) der Datei enthalten. Kann entweder true oder false sein.
createdTime <=, <, =, !=, >, >= Das Datum, an dem die Datei erstellt wurde. Verwenden Sie das RFC 3339-Format. Die Standardzeitzone ist UTC, z. B. 2012-06-04T12:00:00-08:00.

Abfrageoperatoren

In der folgenden Tabelle sind gültige Suchoperatoren aufgeführt:

Operator Nutzung
contains Der Inhalt eines Strings ist im anderen vorhanden.
= Der Inhalt eines Strings oder booleschen Werts ist gleich dem anderen.
!= Der Inhalt eines Strings oder booleschen Werts ist nicht gleich dem anderen.
< Ein Wert ist kleiner als ein anderer.
<= Ein Wert ist kleiner oder gleich einem anderen.
> Ein Wert ist größer als ein anderer.
>= Ein Wert ist größer oder gleich einem anderen.
in Ein Element ist in einer Sammlung enthalten.
and Gibt Elemente zurück, die beiden Abfragen entsprechen.
or Gibt Elemente zurück, die mit einer der beiden Abfragen übereinstimmen.
not Negiert eine Suchanfrage.
has Eine Sammlung enthält ein Element, das den Parametern entspricht.

Beispiele für Abfragen:

  • 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' für Dateien, die dem Nutzer gehören

Verwenden Sie next_page_token, um die Ergebnisse zu paginieren. Eine leere Antwort gibt an, dass es entweder keine Ergebnisse oder keine weiteren Ergebnisse gibt, die zurückgegeben werden können.

Im folgenden Beispiel wird gezeigt, wie Sie mit curl das MCP-Tool search_files aufrufen.

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

Eingabeschema

Anfrage zum Suchen von Dateien

SearchFilesRequest

JSON-Darstellung 
{
  "query": string,

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
Felder
query

string

Die Suchanfrage.

Union-Feld _page_token.

Für _page_token ist nur einer der folgenden Werte zulässig:
pageToken

string

Das Seitentoken für die Paginierung.

Union-Feld _page_size.

Für _page_size ist nur einer der folgenden Werte zulässig:
pageSize

integer

Die maximale Anzahl von Dateien, die auf jeder Seite zurückgegeben werden sollen.

Union-Feld _exclude_content_snippets.

Für _exclude_content_snippets ist nur einer der folgenden Werte zulässig:
excludeContentSnippets

boolean

Wenn „true“, wird der Inhalts-Snippet aus der Antwort ausgeschlossen.

Ausgabeschema

Antwort auf die Suche nach Dateien.

SearchFilesResponse

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

  "nextPageToken": string
}
Felder
files[]

object (File)

Nur Ausgabe. Die Liste der Dateien.

Union-Feld _next_page_token.

Für _next_page_token ist nur einer der folgenden Werte zulässig:
nextPageToken

string

Das Token für die nächste Seite.

Datei

JSON-Darstellung 
{
  "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
}
Felder
id

string

Die ID der abgerufenen Datei.
title

string

Der Titel der Datei.
parentId

string

Die (optionale) ID des übergeordneten Elements der Datei.

Union-Feld _mime_type.

Für _mime_type ist nur einer der folgenden Werte zulässig:
mimeType

string

Der MIME-Typ der Datei.

Union-Feld _file_size.

Für _file_size ist nur einer der folgenden Werte zulässig:
fileSize

string (int64 format)

Die Größe der Datei in Byte.

Union-Feld _description.

Für _description ist nur einer der folgenden Werte zulässig:
description

string

Die Beschreibung der Datei.

Union-Feld _file_extension.

Für _file_extension ist nur einer der folgenden Werte zulässig:
fileExtension

string

Die ursprüngliche Dateiendung der Datei. Dieses Feld wird nur für Dateien mit in Drive gespeicherten Inhalten ausgefüllt.

Union-Feld _content_snippet.

Für _content_snippet ist nur einer der folgenden Werte zulässig:
contentSnippet

string

Generiertes Snippet zum Inhalt der Datei.

Union-Feld _view_url.

Für _view_url ist nur einer der folgenden Werte zulässig:
viewUrl

string

Die URL zum Aufrufen der Datei.

Union-Feld _shared_with_me_time.

Für _shared_with_me_time ist nur einer der folgenden Werte zulässig:
sharedWithMeTime

string (Timestamp format)

Der Zeitpunkt, zu dem die Datei für den Anfragenden freigegeben wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _created_time.

Für _created_time ist nur einer der folgenden Werte zulässig:
createdTime

string (Timestamp format)

Der Zeitpunkt, zu dem die Datei erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _modified_time.

Für _modified_time ist nur einer der folgenden Werte zulässig:
modifiedTime

string (Timestamp format)

Der Zeitpunkt der letzten Änderung der Datei.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _viewed_by_me_time.

Für _viewed_by_me_time ist nur einer der folgenden Werte zulässig:
viewedByMeTime

string (Timestamp format)

Der Zeitpunkt, zu dem die Datei zuletzt vom Antragsteller aufgerufen wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

Union-Feld _owner.

Für _owner ist nur einer der folgenden Werte zulässig:
owner

string

Die E‑Mail-Adresse des Inhabers der Datei.

Zeitstempel

JSON-Darstellung 
{
  "seconds": string,
  "nanos": integer
}
Felder
seconds

string (int64 format)

Stellt Sekunden der UTC-Zeit seit Unix-Epoche 1970-01-01T00:00:00Z dar. Muss einschließlich zwischen -62135596800 und 253402300799 liegen (entspricht 0001-01-01T00:00:00Z bis 9999-12-31T23:59:59Z).
nanos

integer

Nicht negative Sekundenbruchteile Nanosekunden-Auflösung. Dieses Feld enthält den Nanosekundenanteil der Dauer und ist keine Alternative zu Sekunden. Negative Sekundenwerte mit Bruchteilen müssen weiterhin nicht negative Nano-Werte haben, die zeitlich vorwärts gezählt werden. Muss zwischen 0 und 999.999.999 liegen (einschließlich).

Tool-Annotationen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ✅ | Nur-Lese-Hinweis: ✅ | Open-World-Hinweis: ❌