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 tekstowy zapytania składa się z tych 3 części:

query_term operator values

Gdzie:

  • query_term to zapytanie lub pole, w których przypadku ma być wykonywane wyszukiwanie.

  • operator określa warunek dla wyrażenia zapytania.

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

Operatory zapytań

W tabeli poniżej znajdziesz listę prawidłowych operatorów zapytań:

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 innej;
< jedna wartość jest mniejsza od drugiej;
<= Wartość jest mniejsza lub równa innej.
> 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 neguje zapytanie;
has Kolekcja zawiera element pasujący do parametrów.

Wyszukiwane hasła dotyczące plików

Tabela poniżej zawiera listę wszystkich prawidłowych terminów zapytań dotyczących plików. Typy danych i ich opisy znajdziesz w dokumentacji dotyczącej zasobu 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. Otocz je cudzysłowem pojedynczym ('). W zapytaniach użyj znaku \', aby zastąpić cudzysłów pojedynczy, 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. 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.
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 =, != 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 Określa, czy kolekcja rodziców zawiera podany 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. Zapoznaj się z dokumentacją zasobu 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 do pliku (ACL). 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, do którego prowadzi 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 na przykład, że masz nazwę HelloWorld. Zapytanie name contains 'Hello' zwraca wynik, ale zapytanie name contains 'World' nie.

  • Operator contains dopasowuje tylko całe tokeny ciągu w przypadku wyrażenia 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 fullText dokumentu zawiera ciąg „Witaj świecie”, zapytanie fullText contains '"Hello there"' zwróci wynik, ale zapytanie fullText contains '"Hello world"' nie. Ponadto, ponieważ wyszukiwanie jest alfanumeryczne, jeśli pełny tekst dokumentu zawiera ciąg „Hello_world”, zapytaniefullText contains '"Hello world"' zwraca 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. Otocz je cudzysłowem pojedynczym ('). W zapytaniach użyj znaku \', aby zastąpić cudzysłów pojedynczy, 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ść typu ciąg znaków. true

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