MCP Tools Reference: drivemcp.googleapis.com

Araç: list_recent_files

Belirli bir kullanıcının son dosyalarını belirtilen sıralama düzenine göre bulmak için bu aracı çağırın. Varsayılan sıralama düzeni recency'dır.

Desteklenen sıralama düzenleri şunlardır:

  • recency: Dosyanın tarih-saat alanlarındaki en son zaman damgası.
  • lastModified: Dosyanın herhangi bir kullanıcı tarafından en son değiştirildiği zaman.
  • lastModifiedByMe: Dosyanın kullanıcı tarafından en son değiştirildiği zaman.

Varsayılan sayfa boyutu 10'dur. Sonuçlar arasında gezinmek için next_page_token tuşunu kullanın.

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

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

Giriş Şeması

Dosyaları listeleme isteği.

ListFilesRequest

JSON gösterimi 
{

  "orderBy": string

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
Alanlar

_order_by birleşik alanı.

_order_by aşağıdakilerden yalnızca biri olabilir:
orderBy

string

Dosyaların sıralama şekli.

_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

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ı

Dosyaları listeleme isteğine yanıt.

ListFilesResponse

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

  "nextPageToken": string
}
Alanlar
files[]

object (File)

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

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

_can_add_children birleşik alanı.

_can_add_children aşağıdakilerden yalnızca biri olabilir:
canAddChildren

boolean

İstekte bulunan kullanıcının bu klasöre alt öğe ekleyip ekleyemeyeceğini belirtir. Bu, klasör olmayan türler için her zaman yanlıştır.

Zaman damgası

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

string (int64 format)

Unix sıfır zamanı olan 1970-01-01T00:00:00Z tarihinden itibaren UTC saatinin 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: ❌