Interfejs Google Drive API obsługuje kilka sposobów wyszukiwania plików i folderów.
Za pomocą metody files.list
możesz zwrócić wszystkie lub niektóre pliki i foldery użytkownika Dysku. Metody files.list
można też używać do pobierania parametru fileId
wymaganego przez niektóre metody zasobów (np. files.get
i files.update
).
Wyszukaj wszystkie pliki i foldery na Moim dysku bieżącego użytkownika
Aby zwrócić wszystkie pliki i foldery, użyj metody files.list
bez parametrów.
GET https://www.googleapis.com/drive/v3/files
Wyszukaj konkretne pliki lub foldery na Moim dysku bieżącego użytkownika
Aby wyszukać określony zestaw plików lub folderów, użyj pola ciągu zapytania q
z metodą files.list
. Pozwoli to odfiltrować pliki, które mają zostać zwrócone, łącząc co najmniej 1 wyszukiwane hasło.
Ciąg zapytania składa się z 3 części:
query_term operator values
Gdzie:
query_term
to wyszukiwane hasło lub pole w zapytaniu.operator
określa warunek zapytania.values
to konkretne wartości, których chcesz używać do filtrowania wyników wyszukiwania.
Aby wyświetlić terminy i operatory zapytań, których możesz używać w plikach i folderach filtrowania, przeczytaj artykuł Wyszukiwane hasła i operatory zapytań.
Na przykład ten ciąg zapytania filtruje wyniki tak, by zwracał tylko foldery, ustawiając typ MIME:
q: mimeType = 'application/vnd.google-apps.folder'
Więcej informacji o typach MIME znajdziesz w artykule Typy MIME obsługiwane w Google Workspace i na Dysku Google.
Przykłady ciągu zapytania
W tabeli poniżej znajdziesz przykłady podstawowych ciągów zapytań. Rzeczywisty kod różni się w zależności od biblioteki klienta, której używasz do wyszukiwania.
czego ma dotyczyć zapytanie; | Przykład |
---|---|
Pliki o nazwie „Cześć” | name = 'hello' |
Pliki o nazwie zawierającej słowa „cześć” i „do widzenia” | name contains 'hello' and name contains 'goodbye' |
Pliki o nazwie, która nie zawiera słowa „Cześć” | not name contains 'hello' |
Pliki, które zawierają tekst „ważne” i znajdują się w koszu | fullText contains 'important' and trashed = true |
Pliki zawierające słowo „Cześć” | fullText contains 'hello' |
Pliki, które nie zawierają słowa „Cześć” | not fullText contains 'hello' |
Pliki zawierające wyrażenie „witaj świecie” w dokładnie takiej postaci | fullText contains '"hello world"' |
Pliki z zapytaniem zawierającym znak „\” (np. „\authors”) | fullText contains '\\authors' |
Pliki, które są folderami | mimeType = 'application/vnd.google-apps.folder' |
Pliki, które nie są folderami | mimeType != 'application/vnd.google-apps.folder' |
Pliki zmodyfikowane po określonej dacie (domyślna strefa czasowa to UTC) | modifiedTime > '2012-06-04T12:00:00' |
pliki graficzne lub wideo zmodyfikowane po określonej dacie, | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
Pliki oznaczone gwiazdką | starred = true |
plików w kolekcji (np. identyfikatora folderu w kolekcji parents ); |
'1234567' in parents |
pliki w folderze danych aplikacji w kolekcji; | 'appDataFolder' in parents |
Pliki, których właścicielem jest użytkownik „test@example.org” | 'test@example.org' in owners |
Pliki, w przypadku których użytkownik „test@example.org” ma uprawnienia do zapisu | 'test@example.org' in writers |
Pliki, w przypadku których członkowie grupy „grupa@example.org” mają uprawnienia do zapisu | 'group@example.org' in writers |
Pliki udostępnione upoważnionemu użytkownikowi ze słowem „hello” w nazwie | sharedWithMe and name contains 'hello' |
Pliki z niestandardową właściwością pliku widoczną dla wszystkich aplikacji | properties has { key='mass' and value='1.3kg' } |
Pliki z niestandardową właściwością pliku, która jest prywatna dla aplikacji wysyłającej żądanie. | appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' } |
pliki, które nie zostały udostępnione nikomu ani domenie (tylko prywatne lub udostępnione określonym użytkownikom bądź grupom); | visibility = 'limited' |
Filtrowanie wyników wyszukiwania za pomocą biblioteki klienta
Poniższy przykładowy kod pokazuje, jak za pomocą biblioteki klienta filtrować wyniki wyszukiwania według nazw i identyfikatorów plików JPEG. W tym przykładzie użyto zapytania mimeType
do zawężenia wyników do plików typu image/jpeg
. Ustawia też spaces
na drive
, aby dodatkowo zawęzić wyszukiwanie do miejsca na Dysku. Gdy nextPageToken
zwraca wartość null
, nie ma więcej wyników.
Java
Python
Node.js
PHP
Wyszukiwanie plików z niestandardową właściwością pliku
Aby wyszukać pliki z niestandardową właściwością pliku, użyj wyszukiwanego hasła properties
lub appProperties
z kluczem i wartością. Aby np. wyszukać niestandardową właściwość pliku o wartości 8e8aceg2af2ge72e78
, która jest prywatna dla aplikacji wysyłającej żądanie o nazwie additionalID
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Więcej informacji znajdziesz w artykule Dodawanie niestandardowych właściwości plików.
Wyszukiwanie plików z określoną etykietą lub wartością pola
Aby wyszukać pliki z określonymi etykietami, użyj zapytania labels
z określonym identyfikatorem etykiety. Przykład: 'labels/LABEL_ID' in
labels
. Jeśli operacja się uda, treść odpowiedzi będzie zawierała wszystkie instancje plików, do których zastosowano etykietę.
Aby wyszukać pliki bez określonego identyfikatora etykiety: Not
'labels/LABEL_ID' in labels
.
Możesz też wyszukiwać pliki na podstawie określonych wartości pól. Na przykład, aby wyszukać pliki z wartością tekstową: labels/LABEL_ID.text_field_id ='TEXT'
.
Więcej informacji znajdziesz w artykule Wyszukiwanie plików z określoną etykietą lub wartością pola.
Przeszukaj korpusy
W przypadku wyszukiwań wywołujących files.list
domyślnie używana jest wartość corpora
z wartością user
. Aby wyszukać inne korpusy, np. pliki udostępnione kontu domain
, ustaw parametr corpora
.
W jednym zapytaniu można przeszukiwać wiele korpusów, ale jeśli połączony korpus jest zbyt duży, zwracane są niekompletne wyniki. Jeśli incompleteSearch
zawiera wartość true
w treści odpowiedzi, wszystkie dokumenty nie zostały zwrócone. Jeśli tak się stanie, doprecyzuj zapytanie, wybierając inny zbiór, np. user
lub drive
.
Powiązane artykuły
- Wyszukiwanie dysków współdzielonych
- Wyszukiwane hasła i operatory
- Obsługiwane typy MIME w Google Workspace i Dysku Google
- Role i uprawnienia
- Wyszukiwanie plików z określoną etykietą lub wartością pola