Hasła i operatory wyszukiwanego hasła

Ten przewodnik zawiera terminy i operatory zapytań, 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 wyszukiwane hasło lub pole, w którym chcesz wyszukać informacje.

  • operator określa warunek dla terminu zapytania.

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

Operatory zapytań

W tabeli poniżej znajdziesz prawidłowe operatory zapytań:

Operator Wykorzystanie
contains Zawartość jednego ciągu znaków jest obecna w drugim.
= Zawartość ciągu znaków lub wartości logicznej jest równa drugiej wartości.
!= Zawartość ciągu znaków lub wartości logicznej nie jest równa drugiej wartości.
< Wartość jest mniejsza od innej.
<= Wartość jest mniejsza lub równa innej wartości.
> Wartość jest większa od innej.
>= Wartość jest większa lub równa innej wartości.
in Element znajduje się w kolekcji.
and Zwraca elementy pasujące do obu zapytań.
or Zwraca elementy pasujące do dowolnego zapytania.
not Neguje zapytanie.
has Kolekcja zawiera element pasujący do parametrów.

Wyszukiwane hasła dotyczące plików

W tabeli poniżej znajdziesz wszystkie prawidłowe terminy zapytania dotyczące plików. Typy danych i ich opisy znajdziesz w files dokumentacji zasobu.

Wyszukiwane hasło Prawidłowe operatory Wykorzystanie
name contains, =, != Nazwa pliku. Ujmij w pojedyncze cudzysłowy ('). Zmień znaczenie pojedynczych cudzysłowów w zapytaniach za pomocą znaku \', np. 'Valentine\'s Day'.
fullText contains Czy właściwości name, description, indexableText lub tekst w treści pliku albo metadanych pliku są zgodne. Ujmij w pojedyncze cudzysłowy ('). Zmień znaczenie pojedynczych cudzysłowów w zapytaniach za pomocą znaku \', np. 'Valentine\'s Day'.
mimeType contains, =, != Typ MIME pliku. Ujmij w pojedyncze cudzysłowy ('). Zmień znaczenie pojedynczych cudzysłowów w zapytaniach za pomocą znaku \', 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ą ze sobą porównywalne, tylko ze stałymi datami.
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ą ze sobą porównywalne, tylko ze stałymi datami.
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 Czy kolekcja elementów nadrzędnych 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 (ACL) pliku. Może to być true lub false.
createdTime <=, <, =, !=, >, >= Data utworzenia pliku. 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 plików;
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. Ujmij w pojedyncze cudzysłowy (').
shortcutDetails.targetId =, != Identyfikator elementu, do którego prowadzi skrót.

Poniżej znajdziesz przykłady kombinacji operatorów i wyszukiwanych haseł:

  • Operator contains wykonuje tylko dopasowanie prefiksu do terminu contains.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 do terminu fullText. Jeśli na przykład pełny tekst dokumentu zawiera ciąg „HelloWorld”, tylko zapytanie fullText contains 'HelloWorld' zwróci wynik.

  • Operator contains dopasowuje dokładną frazę alfanumeryczną, jeśli prawy operand jest ujęty w cudzysłów. Jeśli np. fullText dokumentu zawiera ciąg „Hello there world”, 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”, zapytanie fullText contains '"Hello world"' zwróci wynik.

  • Terminy owners, writers i readers są pośrednio odzwierciedlone na liście permissions i odnoszą się do role uprawnienia. Pełną listę uprawnień ról znajdziesz w artykule Role i uprawnienia.

Więcej przykładów wyszukiwania ciągów zapytań znajdziesz w artykule Przykłady ciągów zapytań dotyczących plików.

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

Poniższa tabela zawiera listę wszystkich prawidłowych terminów zapytania dotyczących dysków współdzielonych. 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. Format 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órzy są użytkownikami dysku współdzielonego. Przyjmuje wartość liczbową. true
name contains, =, != Nazwa dysku współdzielonego. Ujmij w pojedyncze cudzysłowy ('). Zmień znaczenie pojedynczych cudzysłowów w zapytaniach za pomocą znaku \', np. 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Liczba użytkowników i grup, którzy są organizatorami dysku współdzielonego. Przyjmuje wartość liczbową. true
orgUnitId =, != Identyfikator jednostki organizacyjnej dysku współdzielonego. Przyjmuje wartość w formie ciągu znaków. true

Więcej przykładów wyszukiwania za pomocą ciągu zapytania znajdziesz w artykule Przykłady ciągu zapytania dotyczącego dysku współdzielonego.