Ten przewodnik wyjaśnia, jak interfejs Google Drive API obsługuje kilka sposobów wyszukiwania dysków współdzielonych.
Aby wyszukać określony zestaw dysków współdzielonych, użyj ciągu zapytania q field
z metodą list w zasobie drives, aby odfiltrować dyski do zwrócenia, łącząc co najmniej 1 wyszukiwane hasło.
Ciąg zapytania składa się z tych 3 części:
query_term operator values
Gdzie:
.query_termto wyszukiwane hasło lub pole, w którym chcesz wyszukać informacje.operatorokreśla warunek dla terminu zapytania.valuesto konkretne wartości, których chcesz użyć do filtrowania wyników wyszukiwania.
Na przykład ten ciąg zapytania filtruje wyszukiwanie, aby zwracać tylko dyski współdzielone o nazwie „Zasoby interfejsu Google Drive API”.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
Aby wyświetlić wszystkie terminy wyszukiwania dotyczące dysków współdzielonych, zobacz Terminy wyszukiwania 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 zapytania
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.
Musisz też użyć znaków zmiany znaczenia w nazwach plików, aby zapytanie działało prawidłowo. Jeśli np. nazwa pliku zawiera zarówno apostrof ('), jak i ukośnik lewy ("\"), poprzedź je ukośnikiem lewym: name
contains 'quinn\'s paper\\essay'.
| O co zapytać | Przykład | useDomainAdminAccess ustawienie |
|---|---|---|
Operator dopasowania ciągu znaków (contains) |
||
| Dyski współdzielone z wyrazem „poufne” w nazwie spośród wszystkich dysków współdzielonych, których użytkownik jest członkiem | 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óre w nazwie mają słowo „poufne” i mają co najmniej 20 użytkowników; | name contains 'confidential' and memberCount >= 20 |
true |
| Dyski współdzielone zawierające w nazwie słowo „poufne” spośród wszystkich dysków współdzielonych w 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 haseł w zapytaniu. 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 członkó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 członków.
Interfejs Drive API przetwarza 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, które mają więcej niż 20 użytkowników, nawet te utworzone przed 1 stycznia 2019 r.