MCP Tools Reference: drivemcp.googleapis.com

Alat: search_files

Panggil alat ini untuk menelusuri file Drive berdasarkan kueri terstruktur.

Kolom query memerlukan penggunaan operator penelusuran kueri.

String kueri berisi tiga bagian berikut: query_term operator values dengan:

  • query_term adalah istilah kueri atau kolom yang akan ditelusuri.
  • operator menentukan kondisi untuk istilah kueri.
  • values adalah nilai spesifik yang digunakan untuk memfilter hasil penelusuran Anda.

Persyaratan Kueri

Tabel berikut mencantumkan istilah kueri yang valid beserta deskripsinya:

Istilah Kueri Operator yang valid Penggunaan
title contains, =, != Judul file. Apiti dengan tanda kutip tunggal ('). Pisahkan tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'.
fullText contains Apakah title atau teks dalam konten file cocok. Apiti dengan tanda kutip tunggal ('). Pisahkan tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'.
mimeType contains, =, != Jenis MIME file. Apiti dengan tanda kutip tunggal ('). Pisahkan tanda kutip tunggal dalam kueri dengan \', seperti 'Valentine\'s Day'.
modifiedTime <=, <, =, !=, >, >= Tanggal modifikasi file terakhir. Format RFC 3339, zona waktu default adalah UTC, seperti 2012-06-04T12:00:00-08:00. Kolom jenis date tidak dapat dibandingkan.
viewedByMeTime <=, <, =, !=, >, >= Tanggal saat pengguna terakhir kali melihat file. Format RFC 3339, zona waktu default adalah UTC, seperti 2012-06-04T12:00:00-08:00. Kolom jenis date tidak dapat dibandingkan.
parentId =, != Apakah induk sama dengan ID yang ditentukan. root dapat digunakan untuk menentukan "Drive Saya" pengguna yang berfungsi sebagai hierarki utamanya.
owner =, != Pengguna yang memiliki file. me dapat digunakan untuk menentukan pengguna yang membuat permintaan.
sharedWithMe =, != File yang ada di koleksi "Dibagikan kepada saya" pengguna. Semua pengguna file berada dalam Daftar Kontrol Akses (ACL) file. Dapat berupa true atau false.
createdTime <=, <, =, !=, >, >= Tanggal saat file dibuat. Gunakan format RFC 3339, zona waktu default adalah UTC, seperti 2012-06-04T12:00:00-08:00.

Operator Kueri

Tabel berikut mencantumkan operator kueri yang valid:

Operator Penggunaan
contains Konten satu string ada di string lainnya.
= Konten string atau boolean sama dengan yang lain.
!= Konten string atau boolean tidak sama dengan yang lain.
< Nilai kurang dari nilai lainnya.
<= Nilai kurang dari atau sama dengan nilai lainnya.
> Nilai lebih besar dari nilai lainnya.
>= Nilai lebih besar dari atau sama dengan nilai lainnya.
in Elemen terdapat dalam koleksi.
and Menampilkan item yang cocok dengan kedua kueri.
or Menampilkan item yang cocok dengan salah satu kueri.
not Menegasikan kueri penelusuran.
has Koleksi berisi elemen yang cocok dengan parameter.

Beberapa contoh kueri mencakup:

  • title contains 'hello' and title contains 'goodbye'
  • modifiedTime > '2024-01-01T00:00:00Z' and (mimeType contains 'image/' or mimeType contains 'video/')
  • parentId = '1234567'
  • fullText contains 'hello'
  • owner = 'test@example.org'
  • sharedWithMe = true
  • owner = 'me' (untuk file milik pengguna)

Gunakan next_page_token untuk melakukan penomoran halaman hasil. Respons kosong menunjukkan bahwa tidak ada hasil atau tidak ada lagi hasil yang dapat ditampilkan.

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

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

Skema Input

Meminta untuk menelusuri file.

SearchFilesRequest

Representasi JSON 
{
  "query": string,

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
Kolom
query

string

Kueri penelusuran.

Kolom union _page_token.

_page_token hanya dapat berupa salah satu dari hal berikut:
pageToken

string

Token halaman yang akan digunakan untuk penomoran halaman.

Kolom union _page_size.

_page_size hanya dapat berupa salah satu dari hal berikut:
pageSize

integer

Jumlah maksimum file yang akan ditampilkan di setiap halaman.

Kolom union _exclude_content_snippets.

_exclude_content_snippets hanya dapat berupa salah satu dari hal berikut:
excludeContentSnippets

boolean

Jika benar (true), cuplikan konten akan dikecualikan dari respons.

Skema Output

Respons untuk menelusuri file.

SearchFilesResponse

Representasi JSON 
{
  "files": [
    {
      object (File)
    }
  ],

  "nextPageToken": string
}
Kolom
files[]

object (File)

Hanya output. Daftar file.

Kolom union _next_page_token.

_next_page_token hanya dapat berupa salah satu dari hal berikut:
nextPageToken

string

Token halaman berikutnya.

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