MCP Tools Reference: drivemcp.googleapis.com

Tool: copy_file

Rufen Sie dieses Tool auf, um eine vorhandene Datei in Google Drive zu kopieren. Mit dem Tool können Sie einen neuen Titel und einen übergeordneten Ordner für die Kopie angeben. Wenn der Titel nicht angegeben ist, lautet der Titel der Kopie „Kopie von {original title}“. Wenn der übergeordnete Ordner nicht angegeben ist, wird die Kopie im selben Ordner wie die Originaldatei erstellt, es sei denn, der anfragende Nutzer hat keinen Schreibzugriff auf diesen Ordner. In diesem Fall wird die Kopie im Stammordner des Nutzers erstellt. Gibt das neu erstellte File-Objekt zurück, wenn das Kopieren erfolgreich war.

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

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

Eingabeschema

Eine Datei kopieren

CopyFileRequest

JSON-Darstellung 
{
  "fileId": string,

  "title": string

  "parentId": string
}
Felder
fileId

string

Erforderlich. Die ID der zu kopierenden Datei.

Union-Feld _title.

Für _title ist nur einer der folgenden Werte zulässig:
title

string

Der Titel der neu erstellten Datei. Wenn das Feld leer ist, lautet der Titel „Kopie von [Originaldateititel]“.

Union-Feld _parent_id.

Für _parent_id ist nur einer der folgenden Werte zulässig:
parentId

string

Die übergeordnete ID der neu erstellten Datei. Wenn leer, wird die Datei mit demselben übergeordneten Element wie die Originaldatei erstellt.

Ausgabeschema

Eine Dateiresource.

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

  "canAddChildren": boolean
}
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.

Union-Feld _can_add_children.

Für _can_add_children ist nur einer der folgenden Werte zulässig:
canAddChildren

boolean

Gibt an, ob der Antragsteller diesem Ordner Kinder hinzufügen kann. Für Typen, die keine Ordner sind, ist dieser Wert immer „false“.

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: ❌ | Hinweis „Nur lesen“: ❌ | Hinweis „Offene Welt“: ✅