Ciąg zapytania składa się z 3 części:
query_term operator values
Gdzie:
query_term
to wyszukiwane hasło lub pole zapytania.operator
określa warunek zapytania.values
to konkretne wartości, których chcesz używać do filtrowania wyników wyszukiwania.
W tym dokumencie znajdziesz warunki i operatory zapytań, których możesz używać z interfejsem Google Drive API.
Operatory zapytań
Ta tabela zawiera wszystkie prawidłowe operatory zapytania:
Operator | Wykorzystanie |
---|---|
contains |
Treść jednego ciągu znaków występuje w drugim. |
= |
Zawartość ciągu lub wartości logicznej jest taka sama jak druga. |
!= |
Zawartość ciągu lub wartości logicznej nie jest równa tej drugiej. |
< |
Wartość jest mniejsza od innej. |
<= |
Wartość jest mniejsza od innej wartości lub jej równa. |
> |
Wartość jest większa od innej. |
>= |
Wartość jest większa lub równa innej wartości. |
in |
Element jest zawarty w kolekcji. |
and |
Zwraca elementy pasujące do obu zapytań. |
or |
Zwraca elementy pasujące do dowolnego z tych zapytań. |
not |
Negatuje zapytania. |
has |
Kolekcja zawiera element pasujący do parametrów. |
Zapytania dotyczące konkretnych plików
Poniższa tabela zawiera wszystkie prawidłowe hasła w zapytaniach dotyczących plików. Typy danych i opisy znajdziesz w dokumentacji zasobów files
.
Wyszukiwane hasło | Prawidłowe operatory | Wykorzystanie |
---|---|---|
name |
contains , = , != |
Nazwa pliku. Umieść go w cudzysłowie ' . Zmieniaj znaczenie pojedynczych cudzysłowów w zapytaniach zawierających dyrektywę \' , np. 'Valentine\'s Day' . |
fullText |
contains |
Określa, czy pasują do siebie właściwości name , description , indexableText bądź tekst w treści lub metadanych pliku. Umieść go w cudzysłowie ' . Zmieniaj znaczenie pojedynczych cudzysłowów w zapytaniach zawierających dyrektywę \' , np. 'Valentine\'s Day' . |
mimeType |
contains , = , != |
Typ MIME pliku. Umieść go w cudzysłowie ' . Zmieniaj znaczenie pojedynczych cudzysłowów w zapytaniach zawierających dyrektywę \' , 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 |
= , != |
Określa, czy plik znajduje się w koszu. Możliwe wartości: true lub false . |
starred |
= , != |
Określa, czy plik jest oznaczony gwiazdką. Możliwe wartości: 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. Zapoznaj się z informacjami o zasobach w sekcji Uprawnienia. |
readers |
in |
Użytkownicy lub grupy z uprawnieniami do odczytu pliku. Zapoznaj się z informacjami o zasobach w sekcji Uprawnienia. |
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żliwe wartości: 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 |
Właściwości publicznego pliku niestandardowego. |
appProperties |
has |
Niestandardowe właściwości plików niestandardowych. |
visibility |
= , != |
Poziom widoczności pliku. Prawidłowe wartości to anyoneCanFind , anyoneWithLink , domainCanFind , domainWithLink i limited . Umieść go w cudzysłowie ' . |
shortcutDetails.targetId |
= , != |
Identyfikator elementu, do którego prowadzi skrót. |
Poniżej przedstawiamy kombinacje operatora i hasła w zapytaniu:
Operator
contains
dopasowuje prefiksy tylko do hasełname
. Załóżmy np., że nosisz nazwęHelloWorld
. Zapytaniename contains 'Hello'
zwraca wynik, ale zapytaniename contains 'World'
nie.Operator
contains
dopasowuje tylko tokeny całych ciągów znakówfullText
. Jeśli np. pełny tekst dokumentu zawiera ciąg „HelloWorld”, wynik zwraca tylko zapytaniefullText contains 'HelloWorld'
.Operator
contains
dopasowuje dokładne wyrażenie alfanumeryczne, jeśli jest umieszczone w cudzysłowie prostym. Jeśli np. ciągfullText
dokumentu zawiera ciąg „Witaj świecie”, zapytaniefullText contains '"Hello there"'
zwraca wynik, ale zapytaniefullText contains '"Hello world"'
go nie zawiera. Poza tym wyszukiwanie jest alfanumeryczne, więc jeśli pełny tekst dokumentu zawiera ciąg „Hello_world”, zwraca wynik zapytaniafullText contains '"Hello world"'
.Warunki
owners
,writers
ireaders
są pośrednio widoczne na liściepermissions
– odnoszą się one dorole
w uprawnieniu.
Więcej przykładów wyszukiwania ciągów zapytań znajdziesz w artykule Przykłady ciągu zapytania.
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 Dysku.
Wyszukiwane hasło | Prawidłowe operatory | Wykorzystanie | Wymagane 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żliwe wartości: 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ść go w cudzysłowie ' . Zmieniaj znaczenie pojedynczych cudzysłowów w zapytaniach zawierających dyrektywę \' , np. 'Valentine\'s Day' . |
false |
organizerCount |
<= , < , = , != , > , >= |
Liczba użytkowników i grup, które są organizatorami dysku współdzielonego. Przyjmuje wartość liczbową. | true |
orgUnitId |
= , != |
Identyfikator jednostki organizacyjnej (OU) dysku współdzielonego. Przyjmuje wartość ciągu. | true |