Method: files.list

Wyświetla listę plików użytkownika. Więcej informacji znajdziesz w artykule Wyszukiwanie plików i folderów.

Ta metoda akceptuje parametr q, który jest zapytaniem wyszukiwania łączącym co najmniej 1 wyszukiwane hasło.

Ta metoda domyślnie zwraca wszystkie pliki, w tym pliki w koszu. Jeśli nie chcesz, aby usunięte pliki 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

Treści elementów (plików/dokumentów), do których odnosi się zapytanie. Obsługiwane typy to default, domain, drive i allDrives. Aby oszczędzać energię, wybieraj default lub drive zamiast allDrives.
corpus
(deprecated)

enum (Corpus)

Wycofane: treść elementów (plików/dokumentów), do których odnosi się zapytanie. Użyj w zamian zasady corpora.
driveId

string

Identyfikator dysku współdzielonego, na którym ma być przeprowadzone wyszukiwanie.
includeItemsFromAllDrives

boolean

Czy w wynikach mają być uwzględniane elementy z Mojego dysku i dysków współdzielonych.
includeTeamDriveItems
(deprecated)

boolean

Wycofana: zamiast niej używaj zasady includeItemsFromAllDrives.
maxResults

integer

Maksymalna liczba plików do zwrócenia na stronie. Niepełne lub puste strony wyników mogą pojawić się jeszcze przed osiągnięciem końca listy plików.
orderBy

string

Lista kluczy sortowania rozdzielonych przecinkami. Prawidłowe klucze to:

  • createdDate: kiedy plik został utworzony.
  • folder: identyfikator folderu. To pole jest posortowane alfabetycznie.
  • lastViewedByMeDate: ostatnie wyświetlenie pliku przez użytkownika.
  • modifiedByMeDate: ostatnia modyfikacja pliku przez użytkownika.
  • modifiedDate: ostatnia modyfikacja pliku przez dowolną osobę.
  • quotaBytesUsed: liczba bajtów limitu miejsca na dane wykorzystanych przez plik.
  • recency: najnowsza sygnatura czasowa z pól daty i godziny w pliku.
  • sharedWithMeDate: data udostępnienia pliku użytkownikowi (jeśli dotyczy).
  • starred: informacja, czy użytkownik oznaczył plik gwiazdką.
  • title: tytuł pliku. To pole jest posortowane alfabetycznie, więc 1, 12, 2, 22.
  • title_natural: tytuł pliku. To pole jest sortowane w kolejności naturalnej, czyli 1, 2, 12, 22.

Każdy klucz jest domyślnie sortowany rosnąco, ale można to odwrócić za pomocą modyfikatora „desc”. Przykład użycia: ?orderBy=folder,modifiedDate desc,title.

Pamiętaj, że obecnie istnieje ograniczenie dla użytkowników, którzy mają około miliona plików. W ich przypadku żądana 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 wyszukiwania plików.
spaces

string

Lista rozdzielonych przecinkami przestrzeni do wysłania zapytania. Obsługiwane wartości to drive i appDataFolder.
supportsAllDrives

boolean

Czy aplikacja wysyłająca żądanie obsługuje zarówno Mój dysk, jak i dyski współdzielone.
supportsTeamDrives
(deprecated)

boolean

Wycofana: zamiast niej używaj zasady supportsAllDrives.
teamDriveId
(deprecated)

string

Wycofana: zamiast niej używaj zasady driveId.
includePermissionsForView

string

Określa, które uprawnienia do dodatkowego widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość published.
includeLabels

string

Lista identyfikatorów etykiet rozdzielona przecinkami, które mają być uwzględnione w części labelInfo odpowiedzi.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista plików.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "items": [
    {
      object (File)
    }
  ],
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "incompleteSearch": boolean,
  "nextLink": string
}
Pola
items[]

object (File)

Lista plików. Jeśli pole nextPageToken jest wypełnione, ta lista może być niekompletna i należy pobrać dodatkową stronę wyników.
nextPageToken

string

Token strony z następną stroną plików. Jeśli koniec listy plików został osiągnięty, ten element nie będzie widoczny. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić, a stronicowanie należy rozpocząć od pierwszej strony wyników.
kind

string

Jest to zawsze drive#fileList.
etag

string

ETag listy.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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ą objęte ograniczeniami i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.

Korpus

Wartości w polu enum
DEFAULT elementy, do których użytkownik uzyskał dostęp;
DOMAIN elementy udostępnione w domenie użytkownika;