MCP Tools Reference: drivemcp.googleapis.com

Alat: search_files

Telusuri file Drive menggunakan kueri terstruktur (sintaksis: query_term operator values). Gabungkan klausa dengan and, or, not, dan tanda kurung. Nilai string harus diapit tanda kutip tunggal; escape tanda kutip yang disematkan sebagai \'.

Istilah & operator kueri:

  • title (ops: contains, =, !=) — judul file
  • fullText (ops: contains) — judul atau teks isi
  • mimeType (ops: contains, =, !=) — Jenis MIME
  • modifiedTime, viewedByMeTime, createdTime (opsi: <=, <, =, !=, >, >=). Gunakan UTC RFC 3339, misalnya, 2012-06-04T12:00:00-08:00. Jenis tanggal tidak dapat dibandingkan.
  • parentId (ops: =, !=). Gunakan 'root' untuk "Drive Saya" pengguna.
  • owner (ops: =, !=). Gunakan 'me' untuk pengguna yang meminta.
  • sharedWithMe (ops: =, !=). Nilai: true atau false.

Operator lainnya: and, or, not.

Contoh:

  • 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 membuat penomoran halaman. Respons kosong berarti tidak ada lagi hasil.

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

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": "search_files",
    "arguments": {
      // provide these details according to the tool's 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

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