MCP Tools Reference: drivemcp.googleapis.com

Narzędzie: search_files

Wyszukuj pliki na Dysku za pomocą zapytania strukturalnego (składnia: query_term operator values). Łącz klauzule za pomocą operatorów and, or, not i nawiasów. Wartości ciągu znaków muszą być ujęte w pojedyncze cudzysłowy. Wbudowane cudzysłowy należy poprzedzić znakiem \'.

Wyszukiwane hasła i operatory:

  • title (ops: contains, =, !=) — file title
  • fullText (ops: contains) – tytuł lub tekst główny
  • mimeType (ops: contains, =, !=) – typ MIME
  • modifiedTime, viewedByMeTime, createdTime (ops: <=, <, =, !=, >, >=). Użyj formatu UTC RFC 3339, np. 2012-06-04T12:00:00-08:00. Typy dat nie są porównywalne.
  • parentId (ops: =, !=). Użyj 'root' w przypadku „Mojego dysku” użytkownika.
  • owner (operatorzy: =, !=). Użyj 'me' w przypadku użytkownika wysyłającego żądanie.
  • sharedWithMe (operatorzy: =, !=). Wartości: true lub false.

Inne operatory: and, or, not.

Przykłady:

  • 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' (w przypadku plików należących do użytkownika)

Użyj next_page_token, aby podzielić wyniki na strony. Pusta odpowiedź oznacza, że nie ma więcej wyników.

Poniższy przykład pokazuje, jak za pomocą znaku curl wywołać narzędzie search_files MCP.

Żądanie 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
}'

Schemat danych wejściowych

Prośba o wyszukiwanie plików.

SearchFilesRequest

Zapis JSON 
{
  "query": string,

  "pageToken": string

  "pageSize": integer

  "excludeContentSnippets": boolean
}
Pola
query

string

Wyszukiwane hasło.

Pole zbiorcze _page_token.

Pole _page_token może mieć tylko jedną z tych wartości:
pageToken

string

Token strony do użycia w przypadku podziału na strony.

Pole zbiorcze _page_size.

Pole _page_size może mieć tylko jedną z tych wartości:
pageSize

integer

Maksymalna liczba plików do zwrócenia na każdej stronie.

Pole zbiorcze _exclude_content_snippets.

Pole _exclude_content_snippets może mieć tylko jedną z tych wartości:
excludeContentSnippets

boolean

Jeśli wartość to „true”, fragment treści zostanie wykluczony z odpowiedzi.

Schemat wyjściowy

Odpowiedź na wyszukiwanie plików.

SearchFilesResponse

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

  "nextPageToken": string
}
Pola
files[]

object (File)

Tylko dane wyjściowe. Lista plików.

Pole zbiorcze _next_page_token.

Pole _next_page_token może mieć tylko jedną z tych wartości:
nextPageToken

string

Token następnej strony.

Plik

Zapis 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
}
Pola
id

string

Identyfikator pobranego pliku.
title

string

Tytuł pliku.
parentId

string

(Opcjonalny) identyfikator elementu nadrzędnego pliku.

Pole zbiorcze _mime_type.

Pole _mime_type może mieć tylko jedną z tych wartości:
mimeType

string

Typ MIME pliku.

Pole zbiorcze _file_size.

Pole _file_size może mieć tylko jedną z tych wartości:
fileSize

string (int64 format)

Rozmiar pliku w bajtach.

Pole zbiorcze _description.

Pole _description może mieć tylko jedną z tych wartości:
description

string

Opis pliku.

Pole zbiorcze _file_extension.

Pole _file_extension może mieć tylko jedną z tych wartości:
fileExtension

string

Oryginalne rozszerzenie pliku. To pole jest wypełniane tylko w przypadku plików z zawartością przechowywaną na Dysku.

Pole zbiorcze _content_snippet.

Pole _content_snippet może mieć tylko jedną z tych wartości:
contentSnippet

string

Wygenerowany fragment kodu dotyczący zawartości pliku.

Pole zbiorcze _view_url.

Pole _view_url może mieć tylko jedną z tych wartości:
viewUrl

string

URL umożliwiający wyświetlenie pliku.

Pole zbiorcze _shared_with_me_time.

Pole _shared_with_me_time może mieć tylko jedną z tych wartości:
sharedWithMeTime

string (Timestamp format)

godzinę udostępnienia pliku osobie, która o to poprosiła;

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

Pole zbiorcze _created_time.

Pole _created_time może mieć tylko jedną z tych wartości:
createdTime

string (Timestamp format)

Czas utworzenia pliku.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

Pole zbiorcze _modified_time.

Pole _modified_time może mieć tylko jedną z tych wartości:
modifiedTime

string (Timestamp format)

Ostatni czas modyfikacji pliku.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

Pole zbiorcze _viewed_by_me_time.

Pole _viewed_by_me_time może mieć tylko jedną z tych wartości:
viewedByMeTime

string (Timestamp format)

Najnowszy czas, w którym plik został wyświetlony przez osobę przeglądającą.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

Pole zbiorcze _owner.

Pole _owner może mieć tylko jedną z tych wartości:
owner

string

Adres e-mail właściciela pliku.

Pole zbiorcze _can_add_children.

Pole _can_add_children może mieć tylko jedną z tych wartości:
canAddChildren

boolean

Określa, czy osoba wysyłająca prośbę może dodawać dzieci do tego folderu. W przypadku typów innych niż foldery ta wartość jest zawsze fałszywa.

Sygnatura czasowa

Zapis JSON 
{
  "seconds": string,
  "nanos": integer
}
Pola
seconds

string (int64 format)

Reprezentuje sekundy czasu UTC od epoki uniksowej 1970-01-01T00:00:00Z. Musi mieścić się w przedziale od -62135596800 do 253402300799 (włącznie), co odpowiada zakresowi od 0001-01-01T00:00:00Z do 9999-12-31T23:59:59Z.
nanos

integer

Nieujemne ułamki sekundy w rozdzielczości nanosekundowej. To pole zawiera część czasu trwania w nanosekundach, a nie alternatywę dla sekund. Ujemne wartości sekund z ułamkami muszą mieć nieujemne wartości nanosekund, które liczą czas do przodu. Musi mieścić się w zakresie od 0 do 999 999 999 włącznie.

Adnotacje narzędzi

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌