MCP Tools Reference: drivemcp.googleapis.com

Tool: create_file

Mit diesem Tool können Sie eine Datei in Google Drive erstellen oder hochladen.

Wenn Sie Inhalte hochladen, verwenden Sie für Textinhalte „text_content“. Für Inhalte, die nicht UTF-8-codiert sind, verwenden Sie das Feld „base64_content“ und codieren Sie die Daten mit Base64, um sie in diesem Feld festzulegen.

Bei erfolgreicher Erstellung wird ein einzelnes Datei-Objekt zurückgegeben.

Die folgenden Google-Mime-Typen können ohne Angabe von Inhalten erstellt werden:

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

Ordner können erstellt werden, indem Sie den Mime-Typ auf application/vnd.google-apps.folder festlegen.

Beim Hochladen von Inhalten ist das Feld content_mime_type erforderlich und muss mit dem Typ der hochgeladenen Inhalte übereinstimmen.

Standardmäßig werden unterstützte Inhalte in Google-Mime-Typen konvertiert.

Wenn Sie die Konvertierung für Google-Mime-Typen deaktivieren möchten, legen Sie disable_conversion_to_google_type auf „true“ fest.

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

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

Eingabeschema

Anfrage zum Hochladen einer Datei.

CreateFileRequest

JSON-Darstellung 
{
  "title": string,
  "mimeType": string,
  "contentMimeType": string,
  "content": string,
  "base64Content": string,
  "textContent": string,
  "parentId": string,
  "disableConversionToGoogleType": boolean
}
Felder
title

string

Der Titel der Datei.
mimeType

string

VERWORFEN. NICHT VERWENDEN!! Legen Sie stattdessen „content_mime_type“ fest.
contentMimeType

string

Der Mime-Typ der hochgeladenen Inhalte. Erforderlich, wenn Inhalte jeglicher Art bereitgestellt werden.
content

string

Der Inhalt der Datei, codiert als Base64. Das Feld „content“ muss immer Base64-codiert sein, unabhängig vom Mime-Typ der Datei. VERWORFEN. Verwenden Sie stattdessen „base64_content“ oder „text_content“.
base64Content

string

Optional. Der Base64-codierte Inhalt, der hochgeladen werden soll. Wenn Sie sowohl dieses Feld als auch „text_content“ festlegen, wird ein Fehler ausgelöst.
textContent

string

Optional. Der (UTF-8-)Textinhalt, der hochgeladen werden soll. Wenn Sie sowohl dieses Feld als auch „base64_content“ festlegen, wird ein Fehler ausgelöst.
parentId

string

Die übergeordnete ID der Datei.
disableConversionToGoogleType

boolean

Legen Sie diesen Wert auf „true“ fest, um den übergebenen Mime-Typ für Inhalte beizubehalten und nicht in einen Google-Typ zu konvertieren. Ohne diese Einstellung wird beispielsweise der Mime-Typ „text/plain“ in „application/vnd.google-apps.document“ konvertiert. Hat keine Auswirkungen auf Typen, für die es kein Google-Äquivalent gibt.

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 ist der Nanosekundenanteil der Dauer und 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: ❌ | Schreibgeschützter Hinweis: ❌ | Hinweis zur offenen 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