Hasła i operatory wyszukiwanego hasła

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ł typu name. Załóżmy np., że masz na imię HelloWorld. Zapytanie name contains 'Hello' zwraca wynik, ale zapytanie name contains 'World' już nie.

  • Operator contains dopasowuje tylko tokeny całych ciągów znaków dla hasła fullText. Jeśli np. pełny tekst dokumentu zawiera ciąg „HelloWorld”, tylko zapytanie fullText 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 pole fullText dokumentu zawiera ciąg „Hello world”, zapytanie fullText contains '"Hello there"' zwraca wynik, ale fullText contains '"Hello world"' nie. Ponieważ wyszukiwanie ma postać alfanumeryczną, jeśli pełny tekst dokumentu zawiera ciąg „Hello_world”, zapytanie fullText contains '"Hello world"' zwróci wynik.

  • Warunki owners, writers i readers są pośrednio odzwierciedlone na liście permissions i odnoszą się do role 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.