W tym przewodniku znajdziesz hasła i operatory zapytań, których możesz używać w przypadku Google Drive API do filtrowania plików, folderów i dysków współdzielonych.
Przykłady wyszukiwania plików znajdziesz w sekcji Wyszukiwanie plików i folderów artykułu Korzystanie z Gmaila z użyciem czytnika ekranu.
Przykładowe wyszukiwanie dysków współdzielonych zawiera artykuł 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 wyszukiwania.operator
określa warunek wyszukiwanego hasła.values
to konkretne wartości, których chcesz użyć do filtrowania wyszukiwania wyników.
Operatory zapytań
W tej tabeli znajdziesz prawidłowe operatory zapytania:
Operator | Wykorzystanie |
---|---|
contains |
Zawartość jednego ciągu występuje w drugim. |
= |
Treść ciągu znaków lub wartości logicznej jest równa zawartości innego ciągu. |
!= |
Treść ciągu znaków lub wartości logicznej różni się od zawartości drugiego. |
< |
Jedna wartość jest mniejsza od innej. |
<= |
Wartość jest mniejsza lub równa innej wartości. |
> |
Jedna 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, które pasują do obu zapytań. |
or |
Zwraca produkty pasujące do dowolnego z zapytań. |
not |
Wyklucza wyszukiwane hasło. |
has |
Kolekcja zawiera element pasujący do parametrów. |
Zapytania dotyczące konkretnych plików
Poniższa tabela zawiera wszystkie prawidłowe hasła związane z zapytaniami dotyczącymi plików. Typy danych
opisy, zapoznaj się z zasobami files
odwołania.
Wyszukiwane hasło | Prawidłowe operatory | Wykorzystanie |
---|---|---|
name |
contains , = , != |
Nazwa pliku. Umieść go w cudzysłowie (' ). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem \' , np. 'Valentine\'s Day' . |
fullText |
contains |
Określa, czy są zgodne właściwości name , description , indexableText albo tekst w zawartości lub metadanych pliku. Umieść go w cudzysłowie (' ). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem \' , np. 'Valentine\'s Day' . |
mimeType |
contains , = , != |
Typ MIME pliku. Umieść go w cudzysłowie (' ). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem \' , np. 'Valentine\'s Day' . Więcej informacji na temat typów MIME znajdziesz w artykule Typy MIME obsługiwane przez Google Workspace i Dysk 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 są nieporównywalne ze sobą – mogą to być tylko daty stałe. |
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 są nieporównywalne ze sobą – mogą to być tylko daty stałe. |
trashed |
= , != |
Wskazuje, czy plik znajduje się w koszu. Może to być true lub false . |
starred |
= , != |
Określa, czy plik jest oznaczony gwiazdką. Może to być true lub false . |
parents |
in |
Określa, czy kolekcja nadrzędna zawiera określony identyfikator. |
owners |
in |
Użytkownicy, którzy są właścicielami pliku. |
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 folderze „Udostępnione dla mnie” użytkownika . Wszyscy użytkownicy pliku znajdują się na liście kontroli dostępu (ACL) tego pliku. Może to być true lub false . |
createdTime |
<= , < , = , != , > , >= |
Data utworzenia dysku współdzielonego. Użyj formatu RFC 3339. Domyślna strefa czasowa to UTC, np. 2012-06-04T12:00:00-08:00 . |
properties |
has |
Właściwości publicznego pliku niestandardowego. |
appProperties |
has |
Właściwości prywatnego pliku niestandardowego. |
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 przedstawiliśmy przykładowe kombinacje operatorów i haseł w zapytaniu:
Operator
contains
wyszukuje tylko prefiks w przypadkuname
. Załóżmy na przykład, że masz imię i nazwisko zHelloWorld
. Zapytaniename contains 'Hello'
zwraca błąd wynik, ale zapytaniename contains 'World'
już nie.Operator
contains
wyszukuje tylko tokeny całych ciągów w przypadku terminfullText
. Jeśli na przykład pełny tekst dokumentu zawiera ciąg „HelloWorld”, tylko zapytaniefullText contains 'HelloWorld'
zwraca wynik.Operator
contains
pasuje do dokładnego wyrażenia alfanumerycznego, jeśli w cudzysłowie. Jeśli na przykład elementfullText
dokumentu zawiera ciąg „Witaj świecie”, to zapytaniefullText contains '"Hello there"'
zwraca wynik, alefullText contains '"Hello world"'
nie. Ponadto, ponieważ wyszukiwanie ma postać alfanumeryczną, jeśli pełna tekst dokumentu zawiera ciąg „Hello_world”, po czymfullText contains '"Hello world"'
zwraca wynik.Określenia
owners
,writers
ireaders
są pośrednio odzwierciedlone wpermissions
i zapoznaj się zrole
. Pełną listę uprawnień ról znajdziesz w artykule Role i uprawnienia.
Więcej przykładów wyszukiwania ciągów zapytań znajdziesz w sekcji Ciąg zapytania dotyczącego pliku .
Zapytania dotyczące dysku współdzielonego
W tabeli poniżej znajdziesz wszystkie prawidłowe hasła dotyczące dysków współdzielonych. Typy danych
opisy, zobacz materiał drives
odwołania.
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 będących użytkownikami dysku współdzielonego. Przyjmuje wartość liczbową. | true |
name |
contains , = , != |
Nazwa dysku współdzielonego. Umieść go w cudzysłowie (' ). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem \' , np. 'Valentine\'s Day' . |
true |
organizerCount |
<= , < , = , != , > , >= |
Liczba użytkowników i grup organizatorów dysku współdzielonego. Przyjmuje wartość liczbową. | true |
orgUnitId |
= , != |
Identyfikator jednostki organizacyjnej dysku współdzielonego. Przyjmuje wartość ciągu znaków. | true |
Więcej przykładów wyszukiwania ciągu zapytania znajdziesz w artykule o ciągu zapytania dotyczącego dysku współdzielonego .
Powiązane artykuły
- Wyszukiwanie plików i folderów
- Wyszukiwanie dysków współdzielonych
- Typy MIME obsługiwane przez Google Workspace i Dysk Google
- Role i uprawnienia