Aby zwrócić wszystkie lub tylko niektóre pliki i foldery użytkownika na Dysku, użyj metody files.list
.
Możesz też użyć metody files.list
, aby pobrać fileId
wymagany 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 polecenia files.list
bez parametrów.
Wyszukiwanie konkretnych plików lub folderów na Moim dysku bieżącego użytkownika
Aby wyszukać określony zbiór plików lub folderów, użyj pola ciągu zapytania q
z parametrem files.list
, aby przefiltrować pliki do zwrócenia, łącząc co najmniej 1 wyszukiwane hasło.
Ciąg zapytania składa się z 3 następujących części:
query_term operator values
Gdzie:
query_term
to wyszukiwane hasło lub pole zapytania. Informacje o tym, jak wyświetlić hasła, których można użyć do filtrowania dysków współdzielonych, znajdziesz w sekcji Wyszukiwane hasła i operatory.operator
określa warunek zapytania. Aby sprawdzić, których operatorów możesz używać w przypadku poszczególnych zapytań, przeczytaj artykuł Operatory zapytań.values
to konkretne wartości, których chcesz używać do filtrowania wyników wyszukiwania.
Ten ciąg zapytania pozwala na przykład filtrować wyszukiwanie tak, aby zwracało tylko foldery:
q: mimeType = 'application/vnd.google-apps.folder'
Z przykładu poniżej dowiesz się, jak za pomocą biblioteki klienta filtrować wyniki wyszukiwania według nazw i identyfikatorów plików JPEG. W tym przykładzie użyliśmy zapytania mimeType
, aby zawęzić wyniki do plików typu image/jpeg
. W tym przykładzie spaces
ma też wartość 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
Aby ograniczyć wyszukiwanie do folderów, ustaw typ MIME na q: mimeType = 'application/vnd.google-apps.folder'
przy użyciu ciągu zapytania
Więcej informacji o typach MIME znajdziesz w artykule Typy MIME obsługiwane przez Google Workspace i Dysk Google.
Przykłady ciągu zapytania
Ta tabela zawiera podstawowe ciągi zapytań. Rzeczywisty kod różni się w zależności od biblioteki klienta, której używasz do wyszukiwania.
Czego 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' |
Foldery aplikacji Google lub folderu o typie MIME | mimeType = 'application/vnd.google-apps.folder' |
Pliki, które nie są folderami | mimeType != 'application/vnd.google-apps.folder' |
Pliki zawierające tekst „ważne” i znajdujące się w koszu | fullText contains 'important' and trashed = true |
Pliki zawierające słowo „Cześć” | fullText contains 'hello' |
Pliki bez słowa „halo” | 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. „\autorzy”) | fullText contains '\\authors' |
Pliki z identyfikatorem w kolekcji, np. kolekcja parents |
'1234567' in parents |
pliki w folderze danych aplikacji w kolekcji; | 'appDataFolder' in parents |
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 zmodyfikowane po podanej dacie | modifiedTime > '2012-06-04T12:00:00' // default time zone is UTC |
Pliki udostępnione upoważnionemu użytkownikowi ze słowem „hello” w nazwie | sharedWithMe and name contains 'hello' |
pliki, które nie zostały udostępnione nikomu ani domenom (tylko prywatne lub udostępnione określonym użytkownikom lub grupom). | visibility = 'limited' |
pliki graficzne lub wideo zmodyfikowane po określonej dacie. | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
Wyszukiwanie plików z niestandardową właściwością pliku
Aby wyszukiwać pliki według niestandardowej właściwości pliku, użyj zapytania appProperties
z kluczem i wartością. Aby np. wyszukać właściwość pliku niestandardowego additionalID
z wartością 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Więcej informacji o niestandardowych właściwościach pliku znajdziesz w artykule Dodawanie niestandardowych właściwości pliku.
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. Na przykład: 'labels/LABEL_ID'
in labels
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 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 korpus
Wyszukiwania wywołujące files.list
domyślnie korzystają z korpusu user
. Aby wyszukać inne korpusy, na przykład pliki udostępnione w domenieGoogle Workspace , użyj parametru corpora
.
W jednym zapytaniu można przeszukiwać wiele korpusów, jednak jeśli połączony korpus jest zbyt duży, mogą zostać zwrócone niepełne wyniki. Jeśli wynikiem incompleteSearch
jest true
, nie wszystkie dokumenty zostały zwrócone.