MCP Tools Reference: drivemcp.googleapis.com

Alat: copy_file

Panggil alat ini untuk menyalin File yang ada di Google Drive. Alat ini memungkinkan Anda menentukan judul baru dan folder induk untuk salinan. Jika judul tidak ditentukan, judul salinan akan menjadi 'Salinan {judul asli}'. Jika folder induk tidak ditentukan, salinan akan dibuat di folder yang sama dengan file asli, kecuali jika pengguna yang meminta tidak memiliki akses tulis ke folder tersebut. Dalam hal ini, salinan akan dibuat di folder utama pengguna. Alat ini akan menampilkan objek File yang baru dibuat setelah penyalinan berhasil.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP copy_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": "copy_file",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'
                

Skema Input

Permintaan untuk menyalin file.

CopyFileRequest

Representasi JSON
{
  "fileId": string,

  "title": string

  "parentId": string
}
Kolom
fileId

string

Wajib. ID file yang akan disalin.

Kolom union _title.

_title hanya dapat berupa salah satu dari berikut:

title

string

Judul file yang baru dibuat. Jika kosong, judulnya akan menjadi 'Salinan [judul file asli]'.

Kolom union _parent_id.

_parent_id hanya dapat berupa salah satu dari berikut:

parentId

string

ID induk file yang baru dibuat. Jika kosong, file akan dibuat dengan induk yang sama seperti file asli.

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 (opsional) induk file.

Kolom union _mime_type.

_mime_type hanya dapat berupa salah satu dari berikut:

mimeType

string

Jenis MIME file.

Kolom union _file_size.

_file_size hanya dapat berupa salah satu dari berikut:

fileSize

string (int64 format)

Ukuran file dalam byte.

Kolom union _description.

_description hanya dapat berupa salah satu dari berikut:

description

string

Deskripsi file.

Kolom union _file_extension.

_file_extension hanya dapat berupa salah satu dari 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 berikut:

contentSnippet

string

Cuplikan yang dibuat tentang konten file.

Kolom union _view_url.

_view_url hanya dapat berupa salah satu dari berikut:

viewUrl

string

URL untuk melihat file.

Kolom union _shared_with_me_time.

_shared_with_me_time hanya dapat berupa salah satu dari 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 berikut:

createdTime

string (Timestamp format)

Waktu 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 berikut:

modifiedTime

string (Timestamp format)

Waktu terakhir 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 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 berikut:

owner

string

Alamat email pemilik file.

Kolom union _can_add_children.

_can_add_children hanya dapat berupa salah satu dari 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 nano 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: ✅