MCP Tools Reference: drivemcp.googleapis.com

Alat: create_file

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

Jika mengupload konten, pilih "text_content" untuk konten teks. Untuk konten non-UTF8, gunakan kolom "base64_content" dan lakukan encoding base64 pada data untuk ditetapkan di kolom tersebut.

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.

Saat mengupload konten, kolom content_mime_type wajib diisi dan harus sesuai dengan jenis konten yang diupload.

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

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

Skema Input

Permintaan untuk mengupload file.

CreateFileRequest

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

string

Judul file.
mimeType

string

TIDAK DIGUNAKAN LAGI. JANGAN GUNAKAN!! Tetapkan content_mime_type sebagai gantinya.
contentMimeType

string

Jenis MIME konten yang sedang diupload. Wajib diisi jika jenis konten apa pun diberikan.
content

string

Konten file dienkode sebagai base64. Kolom konten harus selalu dienkode base64, terlepas dari jenis MIME file. TIDAK DIGUNAKAN LAGI. Gunakan base64_content atau text_content sebagai gantinya.
base64Content

string

Opsional. Konten berenkode base64 yang akan diupload. Error akan terjadi jika Anda menetapkan ini dan text_content.
textContent

string

Opsional. Konten teks (UTF-8) yang akan diupload. Error akan terjadi jika Anda menetapkan ini dan base64_content.
parentId

string

ID induk file.
disableConversionToGoogleType

boolean

Tetapkan ke benar (true) untuk mempertahankan jenis MIME konten yang diteruskan dan tidak mengonversi ke jenis Google. Misalnya, tanpa ini, jenis MIME konten text/plain akan dikonversi menjadi application/vnd.google-apps.document. Tidak berpengaruh untuk jenis 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

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

Kolom union _can_add_children.

_can_add_children hanya dapat berupa salah satu dari hal berikut:
canAddChildren

boolean

Apakah pemohon dapat menambahkan anak ke folder ini. Nilai ini selalu salah untuk jenis non-folder.

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: ✅