MCP Tools Reference: drivemcp.googleapis.com

Araç: search_files

Yapılandırılmış bir sorgu verildiğinde Drive dosyalarını aramak için bu aracı çağırın.

query alanında sorgu arama operatörlerinin kullanılması gerekir.

Bir sorgu dizesi aşağıdaki üç bölümü içerir: query_term operator values. Burada:

  • query_term, sorgu terimi veya aranacak alandır.
  • operator, sorgu terimi için koşulu belirtir.
  • values, arama sonuçlarınızı filtrelemek için kullanacağınız değerlerdir.

Sorgu Terimleri

Aşağıdaki tabloda, geçerli sorgu terimleri ve açıklamaları listelenmektedir:

Sorgu Terimi Geçerli operatörler Kullanım
title contains, =, != Dosyanın başlığı. Tek tırnak işareti (') ile çevreleyin. Sorgulardaki tek tırnak işaretlerini \' ile kod dışına alın (ör. 'Valentine\'s Day').
fullText contains Dosya içeriğindeki title veya metnin eşleşip eşleşmediği. Tek tırnak işareti (') ile çevreleyin. Sorgulardaki tek tırnak işaretlerini \' ile kod dışına alın (ör. 'Valentine\'s Day').
mimeType contains, =, != Dosyanın MIME türü. Tek tırnak işareti (') ile çevreleyin. Sorgulardaki tek tırnak işaretlerini \' ile kod dışına alın (ör. 'Valentine\'s Day').
modifiedTime <=, <, =, !=, >, >= Dosyanın son değiştirildiği tarih. RFC 3339 biçimi, varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00). date türündeki alanlar karşılaştırılamaz.
viewedByMeTime <=, <, =, !=, >, >= Kullanıcının bir dosyayı en son görüntülediği tarih. RFC 3339 biçimi, varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00). date türündeki alanlar karşılaştırılamaz.
parentId =, != Üst öğenin belirtilen kimliğe eşit olup olmadığı. root, kullanıcının birincil hiyerarşisi olarak işlev gören "Drive'ım" bölümünü belirtmek için kullanılabilir.
owner =, != Dosyanın sahibi olan kullanıcı me, isteği yapan kullanıcıyı belirtmek için kullanılabilir.
sharedWithMe =, != Kullanıcının "Benimle paylaşılanlar" koleksiyonundaki dosyalar. Tüm dosya kullanıcıları, dosyanın erişim kontrol listesinde (EKL) yer alır. true veya false olabilir.
createdTime <=, <, =, !=, >, >= Dosyanın oluşturulduğu tarih. RFC 3339 biçimini kullanın. Varsayılan saat dilimi UTC'dir (ör. 2012-06-04T12:00:00-08:00).

Sorgu Operatörleri

Aşağıdaki tabloda geçerli sorgu operatörleri listelenmiştir:

Operatör Kullanım
contains Bir dizenin içeriği diğerinde yer alıyor.
= Bir dizenin veya boole değerinin içeriği diğerine eşittir.
!= Bir dizenin veya boole değerinin içeriği diğerine eşit değil.
< Bir değerin diğerinden küçük olması
<= Bir değer, başka bir değerden küçük veya ona eşitse
> Bir değerin diğerinden büyük olması.
>= Bir değer, başka bir değerden büyük veya ona eşitse
in Bir öğe, koleksiyon içinde yer alır.
and Her iki sorguyla da eşleşen öğeleri döndürür.
or İki sorgudan biriyle eşleşen öğeleri döndürür.
not Arama sorgusunu olumsuzlar.
has Koleksiyonda, parametrelerle eşleşen bir öğe bulunur.

Bazı sorgu örnekleri:

  • 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' (kullanıcıya ait dosyalar için)

Sonuçlar arasında gezinmek için next_page_token tuşunu kullanın. Boş yanıt, sonuç olmadığını veya döndürülecek başka sonuç olmadığını gösterir.

Aşağıdaki örnekte, curl kullanılarak search_files MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

Dosyaları arama isteği

SearchFilesRequest

JSON gösterimi 
{
  "query": string,

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
Alanlar
query

string

Arama sorgusu.

_page_token birleşik alanı.

_page_token aşağıdakilerden yalnızca biri olabilir:
pageToken

string

Sayfalara ayırma için kullanılacak sayfa jetonu.

_page_size birleşik alanı.

_page_size aşağıdakilerden yalnızca biri olabilir:
pageSize

integer

Her sayfada döndürülecek maksimum dosya sayısı.

_exclude_content_snippets birleşik alanı.

_exclude_content_snippets aşağıdakilerden yalnızca biri olabilir:
excludeContentSnippets

boolean

Doğruysa içerik snippet'i yanıttan çıkarılır.

Çıkış şeması

Arama dosyalarına yanıt verme

SearchFilesResponse

JSON gösterimi 
{
  "files": [
    {
      object (File)
    }
  ],

  "nextPageToken": string
}
Alanlar
files[]

object (File)

Yalnızca çıkış. Dosya listesi.

_next_page_token birleşik alanı.

_next_page_token aşağıdakilerden yalnızca biri olabilir:
nextPageToken

string

Sonraki sayfa jetonu.

Dosya

JSON gösterimi 
{
  "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
}
Alanlar
id

string

Getirilen dosyanın kimliği.
title

string

Dosyanın başlığı.
parentId

string

Dosyanın üst öğesinin (isteğe bağlı) kimliği.

_mime_type birleşik alanı.

_mime_type aşağıdakilerden yalnızca biri olabilir:
mimeType

string

Dosyanın MIME türü.

_file_size birleşik alanı.

_file_size aşağıdakilerden yalnızca biri olabilir:
fileSize

string (int64 format)

Dosyanın bayt cinsinden boyutu.

_description birleşik alanı.

_description aşağıdakilerden yalnızca biri olabilir:
description

string

Dosyanın açıklaması.

_file_extension birleşik alanı.

_file_extension aşağıdakilerden yalnızca biri olabilir:
fileExtension

string

Dosyanın orijinal dosya uzantısı. Bu alan yalnızca Drive'da depolanan içeriğe sahip dosyalar için doldurulur.

_content_snippet birleşik alanı.

_content_snippet aşağıdakilerden yalnızca biri olabilir:
contentSnippet

string

Dosyanın içeriği hakkında oluşturulan snippet.

_view_url birleşik alanı.

_view_url aşağıdakilerden yalnızca biri olabilir:
viewUrl

string

Dosyayı görüntülemek için kullanılan URL.

_shared_with_me_time birleşik alanı.

_shared_with_me_time aşağıdakilerden yalnızca biri olabilir:
sharedWithMeTime

string (Timestamp format)

Dosyanın istekte bulunan kullanıcıyla paylaşıldığı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

_created_time birleşik alanı.

_created_time aşağıdakilerden yalnızca biri olabilir:
createdTime

string (Timestamp format)

Dosyanın oluşturulduğu zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

_modified_time birleşik alanı.

_modified_time aşağıdakilerden yalnızca biri olabilir:
modifiedTime

string (Timestamp format)

Dosyanın en son değiştirildiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

_viewed_by_me_time birleşik alanı.

_viewed_by_me_time aşağıdakilerden yalnızca biri olabilir:
viewedByMeTime

string (Timestamp format)

Dosyanın, istekte bulunan kullanıcı tarafından en son görüntülendiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

_owner birleşik alanı.

_owner aşağıdakilerden yalnızca biri olabilir:
owner

string

Dosyanın sahibinin e-posta adresi.

Zaman damgası

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Unix sıfır zamanı 1970-01-01T00:00:00Z'den itibaren UTC zamanının saniyelerini gösterir. -62135596800 ile 253402300799 arasında olmalıdır (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir).
nanos

integer

Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, sürenin nanosaniye kısmıdır ve saniyenin alternatifi değildir. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında olmalıdır (bu değerler dahil).

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌