Hasła i operatory wyszukiwanego hasła

Ten przewodnik zawiera wyszukiwane hasła 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 wyszukiwane hasło lub pole, w którym chcesz wyszukać.

  • 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 tabeli poniżej znajdziesz prawidłowe operatory zapytań:

Operator Wykorzystanie
contains Zawartość jednego ciągu jest obecna w drugim.
= Zawartość ciągu lub wartość logiczna jest równa drugiej.
!= Zawartość ciągu lub wartość logiczna nie jest równa drugiej.
< Wartość jest mniejsza od innej.
<= Wartość jest mniejsza lub równa innej.
> Wartość jest większa od innej.
>= Wartość jest większa lub równa innej.
in Element znajduje się w kolekcji.
and Zwróć elementy pasujące do obu zapytań.
or Zwróć 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 wyszukiwane hasła dotyczące plików. Typy danych i opisy znajdziesz w files dokumentacji zasobu

Wyszukiwane hasło Prawidłowe operatory Wykorzystanie
name contains, =, != Nazwa pliku. Umieść w pojedynczych cudzysłowach ('). W zapytaniach używaj znaku (\'), aby zmienić znaczenie pojedynczego cudzysłowu, np. ('Valentine\'s Day').
fullText contains Czy pasują właściwości name, description, indexableText lub tekst w treści pliku albo metadanych pliku. Umieść w pojedynczych cudzysłowach ('). W zapytaniach używaj znaku (\'), aby zmienić znaczenie pojedynczego cudzysłowu, np. ('Valentine\'s Day').
mimeType contains, =, != Typ MIME pliku. Umieść w pojedynczych cudzysłowach ('). W zapytaniach używaj znaku (\'), aby zmienić znaczenie pojedynczego cudzysłowu, 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 z datami stałymi.
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 z datami stałymi.
trashed =, != Czy plik jest w koszu. Może mieć wartość true lub false.
starred =, != Czy plik jest oznaczony gwiazdką. Może mieć wartość true lub false.
parents in Czy kolekcja elementów nadrzędnych 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. Zapoznaj się z dokumentacją zasobu permissions.
sharedWithMe =, != Pliki, które znajdują się w kolekcji „Udostępnione mnie”. Wszyscy użytkownicy pliku znajdują się na liście kontroli dostępu do pliku. Może mieć wartość 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. Obsługiwane tylko w interfejsie Drive API w wersji 3.
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ść w pojedynczych cudzysłowach (').
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 w przypadku wyszukiwanego hasła name. Załóżmy na przykład, że masz nazwę HelloWorld. Zapytanie name contains 'Hello' zwróci wynik, ale zapytanie name contains 'World' nie.

  • Operator contains wykonuje dopasowanie tylko do całych tokenów ciągu w przypadku wyszukiwanego hasła 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 wyrażenie, jeśli prawy operand jest otoczony podwójnymi cudzysłowami. Na przykład:

    • Jeśli fullText dokumentu zawiera ciąg „Hello there world”, zapytanie fullText contains '"Hello there"' zwróci wynik, ale zapytanie fullText contains '"Hello world"' nie.

    • Jeśli pełny tekst dokumentu zawiera ciąg „Hello_world”, to zapytanie fullText contains '"Hello world"' nadal zwróci wynik, ponieważ podkreślenie w ciągu dokumentu jest traktowane jako spacja.

  • Wyszukiwane hasła owners, writers i readers są pośrednio odzwierciedlone na liście permissions i odnoszą się do role w uprawnieniu. Pełną listę uprawnień ról 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 zapytania dotyczących plików.

Wyszukiwane hasła dotyczące dysków współdzielonych

W tabeli poniżej znajdziesz wszystkie prawidłowe wyszukiwane hasła dotyczące dysków współdzielonych. Typy danych i opisy znajdziesz w drives dokumentacji zasobu.

Wyszukiwane hasło Prawidłowe operatory Wykorzystanie Ustawienie useDomainAdminAccess
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 mieć wartość true lub false. false
memberCount <=, <, =, !=, >, >= Liczba użytkowników i grup, które są członkami dysku współdzielonego. Przyjmuje wartość liczbową. true
name contains, =, != Nazwa dysku współdzielonego. Umieść w pojedynczych cudzysłowach ('). W zapytaniach używaj znaku (\'), aby zmienić znaczenie pojedynczego cudzysłowu, 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ść w postaci ciągu znaków. true

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