Hasła i operatory wyszukiwanego hasła

Ten przewodnik zawiera zapytania i operatory, których możesz używać w interfejsie Google Drive API do filtrowania plików, folderów i dysków współdzielonych.

Przykłady wyszukiwania plików znajdziesz w artykule Wyszukiwanie plików i folderów.

Przykłady wyszukiwania dysków współdzielonych znajdziesz w artykule Wyszukiwanie dysków współdzielonych.

Składnia ciągu zapytania

Ciąg zapytania składa się z tych 3 części:

query_term operator values

Gdzie:

  • query_term to zapytanie lub pole, w którym ma być przeprowadzone wyszukiwanie.

  • operator określa warunek wyszukiwanego hasła.

  • values to konkretne wartości, których chcesz użyć do filtrowania wyników wyszukiwania.

Operatory zapytań

W tej tabeli znajdziesz prawidłowe operatory zapytania:

Operator Wykorzystanie
contains Zawartość jednego ciągu występuje w drugim.
= zawartość ciągu znaków lub wartości logicznej jest równa drugiej;
!= zawartość ciągu znaków lub wartości logicznej nie jest równa drugiej;
< jedna wartość jest mniejsza od drugiej;
<= Wartość jest mniejsza lub równa innej.
> Jedna wartość jest większa od innej.
>= Wartość jest większa lub równa innej.
in Element jest zawarty w kolekcji.
and Zwraca elementy pasujące do obu zapytań.
or Zwraca elementy pasujące do obu zapytań.
not Wyklucza wyszukiwane hasło.
has Kolekcja zawiera element pasujący do parametrów.

Zapytania dotyczące konkretnych plików

Tabela poniżej zawiera listę wszystkich prawidłowych terminów zapytań dotyczących plików. Typy i opisy danych znajdziesz w dokumentacji zasobów files.

Wyszukiwane hasło Prawidłowe operatory Wykorzystanie
name contains, =, != Nazwa pliku. Otocz je cudzysłowem pojedynczym ('). W zapytaniach użyj znaku \', aby zastąpić cudzysłów pojedynczy, np. 'Valentine\'s Day'.
fullText contains czy właściwości name, description, indexableText lub tekst w treści lub metadanych pliku są zgodne. Stosuj cudzysłowy pojedyncze ('). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem operatora \', np. 'Valentine\'s Day'.
mimeType contains, =, != Typ MIME pliku. Otocz je cudzysłowem pojedynczym ('). W zapytaniach użyj znaku \', aby zastąpić cudzysłów pojedynczy, np. 'Valentine\'s Day'. Więcej informacji o typach MIME znajdziesz w artykule Obsługiwane typy MIME w Google Workspace i na Dysku Google.
modifiedTime <=, <, =, !=, >, >= Data ostatniej modyfikacji pliku. W formacie RFC 3339 domyślna strefa czasowa to UTC, np. 2012-06-04T12:00:00-08:00. Pola typu date są nieporównywalne ze sobą – mogą to być tylko daty stałe.
viewedByMeTime <=, <, =, !=, >, >= Data ostatniego wyświetlenia pliku przez użytkownika. Format RFC 3339, domyślna strefa czasowa to UTC, np. 2012-06-04T12:00:00-08:00. Pola typu date nie są porównywalne ze sobą, tylko z datami statycznymi.
trashed =, != Wskazuje, czy plik znajduje się w koszu. Może to być true lub false.
starred =, != czy plik jest oznaczony gwiazdką. Może to być true lub false.
parents in Wskazuje, czy kolekcja nadrzędna zawiera określony identyfikator.
owners in Użytkownicy, do których należy plik.
writers in Użytkownicy lub grupy, które mają uprawnienia do modyfikowania pliku. Zapoznaj się z dokumentacją zasobu permissions.
readers in Użytkownicy lub grupy, które mają uprawnienia do odczytu pliku. Zobacz dokumentację zasobów permissions.
sharedWithMe =, != Pliki znajdujące się w kolekcji „Udostępnione dla mnie” użytkownika. Wszyscy użytkownicy pliku znajdują się na liście kontroli dostępu (ACL) tego pliku. Może to być true lub false.
createdTime <=, <, =, !=, >, >= Data utworzenia dysku współdzielonego. Użyj formatu RFC 3339, domyślna strefa czasowa to UTC, np. 2012-06-04T12:00:00-08:00.
properties has Publiczne właściwości niestandardowe pliku.
appProperties has Prywatne właściwości niestandardowe pliku.
visibility =, != Poziom widoczności pliku. Prawidłowe wartości to anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink i limited. Umieścić w cudzysłowie (').
shortcutDetails.targetId =, != Identyfikator elementu wskazanego przez skrót.

Poniżej znajdziesz przykłady kombinacji operatorów i wyrażeń zapytania:

  • Operator contains wykonuje dopasowanie prefiksu tylko w przypadku elementu name. Załóżmy, że masz nazwę HelloWorld. Zapytanie name contains 'Hello' zwraca wynik, ale zapytanie name contains 'World' nie.

  • Operator contains dopasowuje tylko tokeny całych ciągów znaków dla hasła fullText. Jeśli na przykład pełny tekst dokumentu zawiera ciąg „HelloWorld”, tylko zapytanie fullText contains 'HelloWorld' zwraca wynik.

  • Operator contains dopasowuje do dokładnego wyrażenia alfanumerycznego, jeśli jest ono otoczone podwójnymi cudzysłowami. Jeśli na przykład pole fullText dokumentu zawiera ciąg „Hello world”, zapytanie fullText contains '"Hello there"' zwraca wynik, ale fullText contains '"Hello world"' nie. Ponieważ wyszukiwanie jest alfanumeryczne, jeśli pełny tekst dokumentu zawiera ciąg „Hello_world”, zapytaniefullText contains '"Hello world"' zwróci wynik.

  • Warunki owners, writers i readers są pośrednio uwzględnione na liście permissions i odnoszą się do uprawnienia role. Pełną listę uprawnień związanych z rolami znajdziesz w artykule Role i uprawnienia.

Więcej przykładów wyszukiwania za pomocą ciągu zapytania znajdziesz w artykule Przykłady ciągów zapytań do pliku.

Wyszukiwane hasła dotyczące dysku współdzielonego

Tabela poniżej zawiera listę wszystkich prawidłowych terminów zapytań dotyczących dysku współdzielonego. Typy danych i ich opisy znajdziesz w dokumentacji zasobu drives.

Wyszukiwane hasło Prawidłowe operatory Wykorzystanie useDomainAdminAccess ustawienie
createdTime <=, <, =, !=, >, >= Data utworzenia dysku współdzielonego. W formacie RFC 3339 domyślna strefa czasowa to UTC, np. 2012-06-04T12:00:00-08:00. true
hidden =, != Określa, czy dysk współdzielony jest ukryty. Może to być true lub false. false
memberCount <=, <, =, !=, >, >= Liczba użytkowników i grup, które są użytkownikami dysku współdzielonego. Przyjmuje wartość liczbową. true
name contains, =, != Nazwa dysku współdzielonego. Stosuj cudzysłowy pojedyncze ('). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem operatora \', np. 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Liczba użytkowników i grup, które są organizatorami dysku współdzielonego. Przyjmuje wartość liczbową. true
orgUnitId =, != Identyfikator jednostki organizacyjnej dysku współdzielonego. Przyjmuje wartość ciągu znaków. true

Więcej przykładów zapytań z użyciem ciągu zapytania znajdziesz w artykule Przykłady ciągów zapytań związanych z dyskami współdzielonymi.