Interfejs Google Drive API obsługuje kilka sposobów wyszukiwania plików i folderów.
Możesz użyć metody files.list
, aby zwrócić
wszystkie lub niektóre pliki i foldery użytkownika na Dysku. files.list
może być też używana do pobierania fileId
wymaganych dla niektórych zasobów
(takie jak files.get
czy
files.update
).
Wyszukiwanie wszystkich plików i folderów na Moim dysku bieżącego użytkownika
Aby zwrócić wszystkie pliki, użyj metody files.list
bez parametrów
foldery.
GET https://www.googleapis.com/drive/v3/files
Wyszukiwanie określonych plików lub folderów na Moim dysku bieżącego użytkownika
Aby wyszukać określony zestaw plików lub folderów, użyj pola ciągu zapytania q
za pomocą metody files.list
do filtrowania
do zwrócenia, łącząc co najmniej jedno wyszukiwane hasło.
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żyć do filtrowania wyszukiwania wyników.
Aby wyświetlić hasła i operatory zapytania, które można wykorzystać do filtrowania plików i folderów: zobacz Wyszukiwane hasła i operatory.
Na przykład poniższy ciąg zapytania filtruje wyszukiwanie tak, aby zwracało tylko przez ustawienie typu MIME:
q: mimeType = 'application/vnd.google-apps.folder'
Więcej informacji o typach MIME znajdziesz w artykule Google Workspace i Dysk Google obsługiwane typy MIME.
Przykłady ciągów zapytań
W tabeli poniżej znajdziesz przykłady niektórych podstawowych ciągów zapytań. Rzeczywisty kod różni się w zależności od biblioteki klienta używanej do wyszukiwania.
Musisz też zmieniać znaczenie znaków specjalnych w nazwach plików, aby
. Jeśli na przykład nazwa pliku zawiera zarówno apostrof,
('
) i znaku ukośnika lewego ("\"
) użyj ukośnika lewego, aby zmienić znaczenie tych znaków: name
contains 'quinn\'s paper\\essay'
.
Czego dotyczy zapytanie | Przykład |
---|---|
Pliki o nazwie „hello” | 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 zawierające tekst „ważne” i w koszu | fullText contains 'important' and trashed = true |
Pliki zawierające słowo „Cześć” | fullText contains 'hello' |
Pliki bez słowa „Cześć” | not fullText contains 'hello' |
pliki zawierające wyrażenie „Witaj świecie”; | fullText contains '"hello world"' |
Pliki z zapytaniem zawierającym „\” znak (na przykład „\autorzy”) | fullText contains '\\authors' |
Pliki będące 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 |
Pliki w kolekcji (np. identyfikator folderu w kolekcji parents ). |
'1234567' in parents |
Pliki w folderze danych aplikacji w kolekcji | 'appDataFolder' in parents |
Pliki, w przypadku których użytkownik „test@example.org” jest właścicielem | '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 należące do grupy „grupa@example.org” masz uprawnienia do zapisu | 'group@example.org' in writers |
Pliki udostępnione upoważnionemu użytkownikowi za pomocą polecenia „hello” w nazwie | sharedWithMe and name contains 'hello' |
Pliki z własną właściwością pliku widoczną dla wszystkich aplikacji | properties has { key='mass' and value='1.3kg' } |
Pliki z własnością pliku niestandardowego, prywatne dla aplikacji, która wysłała żądanie | appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' } |
pliki, które nie zostały udostępnione nikomu ani w żadnej domenie (tylko prywatne albo udostępnione określonym użytkownikom lub grupom); | visibility = 'limited' |
Filtrowanie wyników wyszukiwania za pomocą biblioteki klienta
Poniższy przykładowy kod pokazuje, jak za pomocą biblioteki klienta filtrować wyszukiwanie
na nazwy i identyfikatory plików JPEG. W tym przykładzie korzystamy z funkcji mimeType
wyszukiwane hasło, aby zawęzić wyniki do plików typu image/jpeg
. Ustawia również
spaces
do drive
, aby jeszcze bardziej zawęzić wyszukiwanie do Dysku
. Gdy nextPageToken
zwraca wartość null
,
nie ma więcej wyników.
Java
Python
Node.js
PHP
Wyszukiwanie plików za pomocą niestandardowej właściwości pliku
Aby wyszukać pliki z własną właściwością pliku, użyj properties
lub
wyszukiwane hasło appProperties
z kluczem i wartością. Aby na przykład:
i wyszukaj niestandardową właściwość pliku, która jest prywatna dla aplikacji wysyłającej żądanie.
additionalID
o wartości 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Więcej informacji znajdziesz w sekcji Dodawanie pliku niestandardowego usługi.
Wyszukiwanie plików z określoną etykietą lub wartością pola
Aby wyszukać pliki z określonymi etykietami, użyj wyszukiwanego hasła labels
o określonym identyfikatorze etykiety. Na przykład: 'labels/LABEL_ID' in
labels
. Jeśli operacja się uda, treść odpowiedzi będzie zawierała wszystkie instancje plików, w których
z 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. Aby na przykład:
wyszukaj pliki zawierające wartość tekstową:
labels/LABEL_ID.text_field_id ='TEXT'
Więcej informacji znajdziesz w artykule Wyszukiwanie plików z określoną etykietą lub polem. .
Przeszukaj korpusy
W przypadku wyszukiwań, które powodują połączenie z numerem files.list
, używany jest parametr
corpora
z user
(domyślnie). Wyszukiwanie
innych korpusów, takich jak pliki udostępnione domain
, ustaw corpora
.
W jednym zapytaniu można przeszukiwać wiele korpusów, chociaż wyniki są niekompletne
może zostać zwrócony, jeśli połączony korpus jest zbyt duży. Jeśli incompleteSearch
to
true
w treści odpowiedzi, nie zostały zwrócone żadne dokumenty. Jeśli
należy zawęzić zapytanie, wybierając inny zbiór, np.
user
lub drive
.
Powiązane artykuły
- Wyszukiwanie dysków współdzielonych
- Wyszukiwane hasła i operatory
- Typy MIME obsługiwane przez Google Workspace i Dysk Google
- Role i uprawnienia
- Wyszukiwanie plików z określoną etykietą lub wartością pola