MCP Tools Reference: drivemcp.googleapis.com

Tool: copy_file

Mit diesem Tool können Sie eine vorhandene Datei in Google Drive kopieren. Sie können einen neuen Titel und einen übergeordneten Ordner für die Kopie angeben. Wenn kein Titel angegeben ist, lautet der Titel der Kopie „Kopie von {Originaltitel}“. Wenn kein übergeordneter Ordner 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. Bei erfolgreicher Kopie wird das neu erstellte Datei-Objekt zurückgegeben.

Im folgenden Beispiel wird gezeigt, wie Sie curl verwenden, um das MCP-Tool copy_file aufzurufen.

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

Eingabeschema

Anfrage zum Kopieren einer Datei.

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 [Originaltitel]“.

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 das Feld leer ist, wird die Datei mit demselben übergeordneten Element wie die Originaldatei erstellt.

Ausgabeschema

Eine Dateiressource.

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 Inhalten ausgefüllt, die in Drive gespeichert sind.

Union-Feld _content_snippet.

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

string

Generierter 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, zu dem die Datei zuletzt geändert 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 _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 Anfragenden 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 Anfragende diesem Ordner untergeordnete Elemente hinzufügen kann. Für andere Typen als Ordner 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. Der Wert 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. Der Wert muss einschließlich zwischen 0 und 999.999.999 liegen.

Toolanmerkungen

Destruktiver Hinweis: ❌ | Idempotenter Hinweis: ❌ | Hinweis „Nur lesen“: ❌ | Hinweis „Offene Welt“: ✅

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file