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łaname
. Załóżmy np., że nazywasz sięHelloWorld
. Zapytaniename contains 'Hello'
zwraca wynik, a zapytaniename contains 'World'
– nie.Operator
contains
dopasowuje tylko tokeny całego ciągu tekstowego do terminufullText
. Jeśli np. pełny tekst dokumentu zawiera ciąg „HelloWorld”, tylko zapytaniefullText 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ągfullText
dokumentu zawiera ciąg „Witaj świecie”, zapytaniefullText contains '"Hello there"'
zwraca wynik, alefullText 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”, zapytaniefullText contains '"Hello world"'
zwraca wynik.Warunki
owners
,writers
ireaders
są pośrednio odzwierciedlone na liściepermissions
i odwołują się do uprawnieniarole
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.
Powiązane artykuły
- Wyszukiwanie plików i folderów
- Wyszukiwanie dysków współdzielonych
- Obsługiwane typy MIME w Google Workspace i Dysku Google
- Role i uprawnienia