Method: files.list

Wyświetla listę plików użytkownika.

Ta metoda akceptuje parametr q, który jest zapytaniem wyszukiwania łączącym co najmniej 1 wyszukiwane hasło. Więcej informacji znajdziesz w przewodniku Wyszukiwanie plików i folderó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 organy to default, domain, drive i allDrives. Aby oszczędzać energię, wybieraj default lub drive zamiast allDrives.
corpus
(deprecated)

enum (Corpus)

Wycofano: treść elementów (plików/dokumentów), do których odnosi się zapytanie. Zamiast niej używaj zasady corpora.
driveId

string

Identyfikator dysku współdzielonego, na którym ma się odbywać 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ą się pojawić 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: data ostatniego wyświetlenia 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: czy użytkownik oznaczył plik gwiazdką.
  • title: tytuł pliku. To pole jest sortowane 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ładowe użycie: ?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 osiągnięto koniec listy plików, 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

Zawsze jest to 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ą ograniczone 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;