MCP Tools Reference: drivemcp.googleapis.com

Alat: create_file

Panggil alat ini untuk membuat atau mengupload File ke Google Drive.

Jika mengupload file, konten harus dienkode base64 ke dalam kolom content, terlepas dari jenis MIME file yang diupload.

Menampilkan satu objek File setelah berhasil dibuat.

Jenis MIME pihak pertama Google Drive berikut dapat dibuat tanpa memberikan konten:

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

Secara default, konversi berikut akan dilakukan untuk jenis MIME berikut:

  • text/plain hingga application/vnd.google-apps.document
  • text/csv hingga application/vnd.google-apps.spreadsheet

Untuk menonaktifkan konversi untuk jenis MIME pihak pertama, tetapkan disable_conversion_to_google_type ke benar (true).

Folder dapat dibuat dengan menyetel jenis MIME ke application/vnd.google-apps.folder.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP create_file.

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

Skema Input

Permintaan untuk mengupload file.

CreateFileRequest

Representasi JSON 
{
  "title": string,
  "mimeType": string,
  "content": string,
  "parentId": string,
  "disableConversionToGoogleType": boolean
}
Kolom
title

string

Judul file.
mimeType

string

Jenis MIME file yang akan diupload.
content

string

Konten file dienkode sebagai base64. Kolom konten harus selalu dienkode base64, terlepas dari jenis MIME file.
parentId

string

ID induk file.
disableConversionToGoogleType

boolean

Jika benar, file tidak akan dikonversi ke jenis Google. Tidak berpengaruh untuk jenis MIME yang tidak memiliki padanan Google.

Skema Output

Resource file.

File

Representasi 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
}
Kolom
id

string

ID file yang diambil.
title

string

Judul file.
parentId

string

ID induk file (opsional).

Kolom union _mime_type.

_mime_type hanya dapat berupa salah satu dari hal berikut:
mimeType

string

Jenis MIME file.

Kolom union _file_size.

_file_size hanya dapat berupa salah satu dari hal berikut:
fileSize

string (int64 format)

Ukuran file dalam byte.

Kolom union _description.

_description hanya dapat berupa salah satu dari hal berikut:
description

string

Deskripsi file.

Kolom union _file_extension.

_file_extension hanya dapat berupa salah satu dari hal berikut:
fileExtension

string

Ekstensi file asli, hanya diisi untuk file dengan konten yang disimpan di Drive.

Kolom union _content_snippet.

_content_snippet hanya dapat berupa salah satu dari hal berikut:
contentSnippet

string

Cuplikan yang dihasilkan tentang konten file.

Kolom union _view_url.

_view_url hanya dapat berupa salah satu dari hal berikut:
viewUrl

string

URL untuk melihat file.

Kolom union _shared_with_me_time.

_shared_with_me_time hanya dapat berupa salah satu dari hal berikut:
sharedWithMeTime

string (Timestamp format)

Waktu file dibagikan kepada pemohon.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Kolom union _created_time.

_created_time hanya dapat berupa salah satu dari hal berikut:
createdTime

string (Timestamp format)

Waktu saat file dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Kolom union _modified_time.

_modified_time hanya dapat berupa salah satu dari hal berikut:
modifiedTime

string (Timestamp format)

Waktu terakhir kali file diubah.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Kolom union _viewed_by_me_time.

_viewed_by_me_time hanya dapat berupa salah satu dari hal berikut:
viewedByMeTime

string (Timestamp format)

Waktu terakhir file dilihat oleh pemohon.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

Kolom union _owner.

_owner hanya dapat berupa salah satu dari hal berikut:
owner

string

Alamat email pemilik file.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ✅