Ten przewodnik wyjaśnia, jak Google Drive API obsługuje kilka sposobów wyszukiwania dysków współdzielonych.
Aby wyszukać określony zestaw dysków współdzielonych, użyj pola ciągu zapytania q
z metodą list w zasobie drives. Możesz filtrować dyski, które mają być zwracane,
łącząc co najmniej 1 wyszukiwane słowo.
Ciąg zapytania składa się z tych 3 części:
query_term operator values
Gdzie:
query_termto wyszukiwane słowo lub pole, w którym ma być prowadzone wyszukiwanie.operatorokreśla warunek dla wyszukiwanego słowa.valuesto konkretne wartości, których chcesz użyć do filtrowania wyników wyszukiwania.
Na przykład ten ciąg zapytania filtruje wyszukiwanie tak, aby zwracać tylko dyski współdzielone o nazwie „Google Drive API resources”.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
Aby wyświetlić wszystkie wyszukiwane słowa dotyczące dysków współdzielonych, zobacz Wyszukiwane słowa dotyczące dysków współdzielonych.
Aby wyświetlić wszystkie operatory zapytań, których możesz użyć do utworzenia zapytania, zobacz Operatory zapytań.
Przykłady ciągów zapytań
W tabeli poniżej znajdziesz przykłady podstawowych ciągów zapytań dotyczących dysków współdzielonych. Rzeczywisty kod różni się w zależności od biblioteki klienta używanej do wyszukiwania.
Aby zapytanie działało prawidłowo, musisz też poprzedzić znakiem ucieczki znaki specjalne w nazwach plików. Jeśli na przykład nazwa pliku zawiera zarówno apostrof
('), jak i ukośnik lewy ("\"), użyj ukośnika lewego, aby je poprzedzić znakiem ucieczki: name
contains 'quinn\'s paper\\essay'.
| Co chcesz wyszukać | Przykład | Ustawienie useDomainAdminAccess |
|---|---|---|
Operator dopasowania ciągu (contains) |
||
| Dyski współdzielone, których użytkownik jest członkiem i których nazwa zawiera słowo „confidential” | name contains 'confidential' |
false |
Operatory równości i nierówności (=, !=) |
||
| Dyski współdzielone widoczne w widoku domyślnym | hidden = false |
false |
| Dyski współdzielone ukryte w widoku domyślnym | hidden = true |
false |
| Dyski współdzielone bez przypisanego organizatora | organizerCount = 0 |
true |
| Dyski współdzielone z dokładnie 1 użytkownikiem | memberCount = 1 |
true |
| Dyski współdzielone należące do jednostki organizacyjnej o podanym identyfikatorze | orgUnitId = 'C03az79cb' |
true |
| Dyski współdzielone, które nie zawierają identyfikatora jednostki organizacyjnej | orgUnitId != 'C03az79cb' |
true |
| Dyski współdzielone o nazwach niezgodnych z określoną nazwą | name != 'Archived Projects' |
true |
Operatory porównania (>, >=, <, <=) |
||
| Dyski współdzielone utworzone po 1 czerwca 2017 r. | createdTime > '2017-06-01T12:00:00' |
true |
| Dyski współdzielone utworzone przed 1 stycznia 2023 r. | createdTime < '2023-01-01T00:00:00' |
true |
| Dyski współdzielone z więcej niż 1 użytkownikiem | memberCount > 1 |
true |
| Dyski współdzielone z mniej niż 5 użytkownikami | memberCount < 5 |
true |
| Dyski współdzielone z maksymalnie 3 organizatorami | organizerCount <= 3 |
true |
Operatory logiczne (and, or, not) |
||
| Dyski współdzielone, których nazwa zawiera słowo „confidential” i które mają co najmniej 20 użytkowników | name contains 'confidential' and memberCount >= 20 |
true |
| Dyski współdzielone, których nazwa zawiera słowo „confidential” i które należą do organizacji | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
| Dyski współdzielone o nazwach zawierających słowo „Project” lub „Archive” | name contains 'Project' or name contains 'Archive' |
true |
| Dyski współdzielone, których nazwa nie zawiera słowa „Draft” | not name contains 'Draft' |
true |
| Dyski współdzielone, które nie należą do docelowej jednostki organizacyjnej i zostały utworzone po określonej dacie | orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' |
true |
Wyszukiwanie wielu haseł za pomocą nawiasów
Możesz używać nawiasów, aby grupować wiele wyszukiwanych słów. Aby na przykład wyszukać dyski współdzielone utworzone po określonej dacie, które mają więcej niż 5 organizatorów lub więcej niż 20 użytkowników, użyj tego zapytania:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)
To wyszukiwanie zwraca wszystkie dyski współdzielone utworzone po 1 stycznia 2019 r., które mają więcej niż 5 organizatorów lub więcej niż 20 użytkowników.
Drive API ocenia operatory and i or od lewej do prawej, więc to samo wyszukiwanie bez nawiasów zwróci:
- tylko dyski współdzielone z więcej niż 5 organizatorami, które zostały utworzone po 1 stycznia 2019 r.;
- wszystkie dyski współdzielone z więcej niż 20 użytkownikami, nawet te utworzone przed 1 stycznia 2019 r.