W tym przewodniku znajdziesz hasła i operatory zapytań, których możesz używać za pomocą interfejsu 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żywać do filtrowania wyników wyszukiwania.
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 i opisy danych znajdziesz w dokumentacji zasobów files
.
Wyszukiwane hasło | Prawidłowe operatory | Wykorzystanie |
---|---|---|
name |
contains , = , != |
Nazwa pliku. Stosuj cudzysłowy pojedyncze (' ). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem operatora \' , 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. Stosuj cudzysłowy pojedyncze (' ). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem operatora \' , np. 'Valentine\'s Day' . |
mimeType |
contains , = , != |
Typ MIME pliku. Stosuj cudzysłowy pojedyncze (' ). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem operatora \' , 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 kolekcji „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
dopasowuje tylko prefiksy haseł typuname
. Załóżmy np., że masz na imięHelloWorld
. Zapytaniename contains 'Hello'
zwraca wynik, ale zapytaniename contains 'World'
już nie.Operator
contains
dopasowuje tylko tokeny całych ciągów znaków dla hasłafullText
. Jeśli np. pełny tekst dokumentu zawiera ciąg „HelloWorld”, tylko zapytaniefullText contains 'HelloWorld'
zwróci wynik.Operator
contains
pasuje do wyrażenia w dopasowaniu alfanumerycznym, jeśli jest ono podane w cudzysłowie. Jeśli na przykład polefullText
dokumentu zawiera ciąg „Hello world”, zapytaniefullText contains '"Hello there"'
zwraca wynik, alefullText contains '"Hello world"'
nie. Ponieważ wyszukiwanie ma postać alfanumeryczną, jeśli pełny tekst dokumentu zawiera ciąg „Hello_world”, zapytaniefullText contains '"Hello world"'
zwróci wynik.Warunki
owners
,writers
ireaders
są pośrednio odzwierciedlone na liściepermissions
i odnoszą się dorole
w uprawnieniu. 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 przykładowe ciągi zapytań w 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 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 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. Stosuj cudzysłowy pojedyncze (' ). Zmiana znaczenia pojedynczych cudzysłowów w zapytaniach z użyciem operatora \' , 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 zapytań z użyciem ciągu zapytania znajdziesz w artykule Przykłady ciągów zapytań związanych z dyskami współdzielonymi.
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