Wyświetla listę plików użytkownika.
Ta metoda akceptuje parametr q
, czyli zapytanie łączące co najmniej jedno wyszukiwane hasło. Więcej informacji znajdziesz w artykule Wyszukiwanie plików .
Żądanie HTTP
GET https://www.googleapis.com/drive/v3/files
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
corpora |
jednostki elementów (plików/dokumentów), których dotyczy zapytanie; Obsługiwane treści to „user”, „domain”, „drive” i „allDrives”. Preferuj użytkownika lub „drive” do „allDrives” pod kątem wydajności. Domyślnie korpus ma wartość „użytkownik”. Może się to jednak zmienić w zależności od filtra ustawionego za pomocą znaku „q”. . |
corpus |
Wycofane: źródło plików do wyświetlenia. Użyj elementu „corpora” . |
driveId |
Identyfikator dysku współdzielonego do przeszukania. |
includeItemsFromAllDrives |
Określa, czy w wynikach mają być uwzględnione elementy z Mojego dysku i dysku współdzielonego. |
includeTeamDriveItems |
Wycofane: użyj atrybutu |
orderBy |
Rozdzielona przecinkami lista kluczy sortowania. Prawidłowe klucze to „createdTime”, „folder”, „modifiedByMeTime”, „modifiedTime”, „name”, „name_natural”, „quotaBytesUsed”, „recency”, „sharedWithMeTime”, „starred” i „viewedByMeTime”. Każdy klucz domyślnie sortuje rosnąco, ale można to odwrócić za pomocą polecenia „malejąco” modyfikator. Przykład użycia: ?orderBy=folder,modifiedTime desc,name. |
pageSize |
Maksymalna liczba plików zwracanych na stronę. Częściowe lub puste strony z wynikami mogą pojawiać się nawet przed osiągnięciem końca listy plików. |
pageToken |
Token kontynuujący poprzednie żądanie listy na następnej stronie. Należy ustawić wartość „nextPageToken” niż w przypadku poprzedniej odpowiedzi. |
q |
Zapytanie służące do filtrowania wyników w pliku. Zobacz sekcję „Wyszukiwanie plików i foldery” . |
spaces |
Rozdzielona przecinkami lista spacji, na które ma zostać wysłane zapytanie w obrębie korpusów. Obsługiwane wartości to „drive”. i „appDataFolder”. |
supportsAllDrives |
Określa, czy aplikacja, której dotyczy prośba, obsługuje zarówno Mój dysk, jak i dyski współdzielone. |
supportsTeamDrives |
Wycofane: użyj atrybutu |
teamDriveId |
Wycofane: użyj atrybutu |
includePermissionsForView |
Określa uprawnienia dodatkowego widoku danych, które mają być uwzględnione w odpowiedzi. Tylko „opublikowane” jest obsługiwane. |
includeLabels |
Rozdzielona przecinkami lista identyfikatorów etykiet, które mają zostać uwzględnione w części |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Listę plików.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"nextPageToken": string,
"kind": string,
"incompleteSearch": boolean,
"files": [
{
object ( |
Pola | |
---|---|
nextPageToken |
Token strony dla następnej strony z plikami. Nie będzie on brakujący, jeśli dojdzie do końca listy plików. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go unieważnić, a podział na strony powinien rozpocząć się od nowa na pierwszej stronie wyników. Token strony jest zwykle ważny przez kilka godzin. Jeśli jednak dodasz lub usuniesz nowe elementy, oczekiwane wyniki mogą się różnić. |
kind |
Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków |
incompleteSearch |
Informacja, czy proces wyszukiwania był niekompletny. Jeśli ma wartość prawda, może brakować niektórych wyników wyszukiwania, ponieważ nie przeszukano wszystkich dokumentów. Może się to zdarzyć, gdy przeszukujesz wiele przejazdów za pomocą atrybutu „allDrives” korpusy, ale nie udało się przeszukać wszystkich korpusów. W takim przypadku zalecamy zawężenie zapytania, wybierając inny zbiór, na przykład „użytkownik”. lub „drive”. |
files[] |
Lista plików. Jeśli pole nextPageToken jest wypełnione, ta lista może być niekompletna i powinna zostać pobrana dodatkowa strona z wynikami. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
Niektóre zakresy są ograniczone. Aby można było z nich korzystać, aplikacja musi przeprowadzić ocenę zabezpieczeń. Więcej informacji znajdziesz w przewodniku na temat autoryzacji.
Korpus
Wartości w polu enum | |
---|---|
user |
Pliki należące do użytkownika lub mu udostępnione. |
domain |
pliki udostępnione w domenie użytkownika; |