Hasła i operatory wyszukiwanego hasła

W tym przewodniku znajdziesz 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ład 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 3 części:

query_term operator values

Gdzie:

  • query_term to wyszukiwane hasło lub pole w zapytaniu.

  • operator określa warunek zapytania.

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

Operatory zapytań

Poniższa tabela zawiera prawidłowe operatory zapytania:

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

Zapytania dotyczące konkretnych plików

Poniższa tabela zawiera wszystkie prawidłowe zapytania dotyczące plików. Typy danych i opisy znajdziesz w dokumentacji zasobów files.

Wyszukiwane hasło Prawidłowe operatory Wykorzystanie
name contains, =, != Nazwa pliku. Umieść w cudzysłowie pojedynczym ('). Używaj funkcji \', aby zmieniać znaczenie poszczególnych cudzysłowów w zapytaniach, np. 'Valentine\'s Day'.
fullText contains Wskazuje, czy pasują do siebie właściwości name, description, indexableText bądź tekst w zawartości lub metadanych pliku. Umieść w cudzysłowie pojedynczym ('). Używaj funkcji \', aby zmieniać znaczenie poszczególnych cudzysłowów w zapytaniach, np. 'Valentine\'s Day'.
mimeType contains, =, != Typ pliku. Umieść w cudzysłowie pojedynczym ('). Używaj funkcji \', aby zmieniać znaczenie poszczególnych cudzysłowów w zapytaniach, np. 'Valentine\'s Day'. Więcej informacji o typach MIME znajdziesz w artykule na temat obsługiwanych typów 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 =, != Wskazuje, czy plik znajduje się w koszu. Może mieć wartość true lub false.
starred =, != Wskazuje, czy plik jest oznaczony gwiazdką. Może mieć wartość true lub false.
parents in Określa, czy kolekcja nadrzędna zawiera określony identyfikator.
owners in Użytkownicy, do których plik należy.
writers in Użytkownicy lub grupy z uprawnieniami do modyfikowania pliku. Zobacz dokumentację zasobów permissions.
readers in Użytkownicy lub grupy z uprawnieniami do odczytu pliku. Zobacz dokumentację zasobów permissions.
sharedWithMe =, != pliki znajdujące się w kolekcji „Udostępnione dla mnie” użytkownika, Wszyscy użytkownicy znajdują się na liście kontroli dostępu (ACL) danego pliku. Może mieć wartość true lub false.
createdTime <=, <, =, !=, >, >= Data utworzenia dysku współdzielonego. Użyj formatu RFC 3339. Domyślną strefą czasową jest UTC, np. 2012-06-04T12:00:00-08:00.
properties has Niestandardowe właściwości plików publicznych.
appProperties has Niestandardowe właściwości plików prywatnych.
visibility =, != Poziom widoczności pliku. Prawidłowe wartości to anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink i limited. Umieść je w cudzysłowie (').
shortcutDetails.targetId =, != Identyfikator elementu, na który wskazuje skrót.

Poniżej przedstawiamy kombinacje operatora i hasła w zapytaniu:

  • Operator contains dopasowuje prefiksy tylko do hasła name. Załóżmy np., że nazywasz się HelloWorld. Zapytanie name contains 'Hello' zwraca wynik, a zapytanie name contains 'World' – nie.

  • Operator contains dopasowuje tylko tokeny całego ciągu tekstowego do terminu fullText. Jeśli np. pełny tekst dokumentu zawiera ciąg „HelloWorld”, tylko zapytanie fullText contains 'HelloWorld' zwróci wynik.

  • Operator contains pasuje do dokładnego wyrażenia alfanumerycznego, jeśli jest ujęty w podwójne cudzysłowy. Jeśli np. ciąg fullText dokumentu zawiera ciąg „Witaj świecie”, zapytanie fullText contains '"Hello there"' zwraca wynik, ale fullText contains '"Hello world"' już go nie zawiera. Poza tym wyszukiwanie ma postać alfanumeryczną, więc jeśli pełny tekst dokumentu zawiera ciąg „Hello_world”, zapytanie fullText contains '"Hello world"' zwraca wynik.

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

Więcej przykładów wyszukiwania ciągu zapytania znajdziesz w artykule Przykłady ciągu zapytania dotyczącego plików.

Zapytania dotyczące dysku współdzielonego

Poniższa tabela zawiera wszystkie prawidłowe zapytania dotyczące dysku współdzielonego. Typy danych i opisy znajdziesz w dokumentacji zasobów 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 mieć wartość true lub false. false
memberCount <=, <, =, !=, >, >= Liczba użytkowników i grup będących użytkownikami dysku współdzielonego. Przyjmuje wartość liczbową. true
name contains, =, != Nazwa dysku współdzielonego. Umieść w cudzysłowie pojedynczym ('). Używaj funkcji \', aby zmieniać znaczenie poszczególnych cudzysłowów w zapytaniach, 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ść ciągu. true

Więcej przykładów wyszukiwania ciągu zapytania znajdziesz w artykule Przykłady ciągu zapytania na dysku współdzielonym.