Ta strona została przetłumaczona przez Cloud Translation API.

Method: files.list

Żądanie HTTP
Parametry zapytania
Treść żądania
Treść odpowiedzi
- Zapis JSON
Zakresy autoryzacji
Korpus
Wypróbuj

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 .

Uwaga: ta metoda domyślnie zwraca wszystkie pliki, w tym te przeniesione do kosza. Jeśli nie chcesz, aby pliki przeniesione do kosza pojawiały się na liście, użyj parametru zapytania trashed=false, aby usunąć je z wyników.

Żądanie HTTP

GET https://www.googleapis.com/drive/v2/files

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
`corpora`	`string` jednostki elementów (plików/dokumentów), których dotyczy zapytanie; Obsługiwane treści to `default`, `domain`, `drive` i `allDrives`. Ze względu na wydajność preferuj `default` lub `drive`: `allDrives`.
`corpus (deprecated)`	`enum (Corpus)` Wycofane: treść elementów (plików/dokumentów), których dotyczy zapytanie. Użyj w zamian zasady `corpora`.
`driveId`	`string` Identyfikator dysku współdzielonego do przeszukania.
`includeItemsFromAllDrives`	`boolean` Określa, czy w wynikach mają być uwzględnione elementy z Mojego dysku i dysku współdzielonego.
`includeTeamDriveItems (deprecated)`	`boolean` Wycofane: użyj atrybutu `includeItemsFromAllDrives`.
`maxResults`	`integer` 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.
`orderBy`	`string` Rozdzielona przecinkami lista kluczy sortowania. Prawidłowe klucze to `createdDate`, `folder`, `lastViewedByMeDate`, `modifiedByMeDate`, `modifiedDate`, `quotaBytesUsed`, `recency`, `sharedWithMeDate`, `starred`, `title` i `title_natural`. Każdy klucz domyślnie sortuje dane rosnąco, ale można to zmienić, używając modyfikatora `desc`. Przykład użycia: ?orderBy=folder,modifiedDate desc,title. Pamiętaj, że aktualnie obowiązuje ograniczenie dotyczące użytkowników liczących około miliona plików, w przypadku których wymagana kolejność sortowania jest ignorowana.
`pageToken`	`string` Token strony dla plików.
`projection (deprecated)`	`enum (Projection)` Wycofano: ten parametr nie ma funkcji.
`q`	`string` Ciąg zapytania do wyszukania plików.
`spaces`	`string` Rozdzielona przecinkami lista spacji, na które ma zostać wysłane zapytanie. Obsługiwane wartości to `drive` i `appDataFolder`.
`supportsAllDrives`	`boolean` Określa, czy aplikacja, której dotyczy prośba, obsługuje zarówno Mój dysk, jak i dyski współdzielone.
`supportsTeamDrives (deprecated)`	`boolean` Wycofane: użyj atrybutu `supportsAllDrives`.
`teamDriveId (deprecated)`	`string` Wycofane: użyj atrybutu `driveId`.
`includePermissionsForView`	`string` Określa uprawnienia dodatkowego widoku danych, które mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość `published`.
`includeLabels`	`string` Rozdzielona przecinkami lista identyfikatorów etykiet, które mają zostać uwzględnione w części `labelInfo` odpowiedzi.

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, "etag": string, "selfLink": string, "incompleteSearch": boolean, "nextLink": string, "items": [ { object (`File`) } ] }

Pola
`nextPageToken`	`string` 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.
`kind`	`string` To zawsze `drive#fileList`.
`etag`	`string` Identyfikator ETag listy.
`selfLink`	`string` Link powrotny do tej listy.
`incompleteSearch`	`boolean` 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ć podczas wyszukiwania wielu przejazdów za pomocą parametru „allDrives” korpusy, ale nie udało się przeszukać wszystkich korpusów. W takiej sytuacji klient powinien zawęzić zapytanie, wybierając inny korpus, na przykład „default” (domyślnego). czy „samochodem”.
`nextLink`	`string` Link do następnej strony z plikami.
`items[]`	`object (File)` 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/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
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
`DEFAULT`	Elementy, do których użytkownik miał dostęp.
`DOMAIN`	Elementy udostępnione w domenie użytkownika.