Method: files.list

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

Ta metoda akceptuje parametr q, który jest zapytaniem łączącym co najmniej jedno wyszukiwane hasło. Więcej informacji znajdziesz w przewodniku po wyszukiwaniu 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

Zwłoki (pliki/dokumenty), których dotyczy zapytanie. Obsługiwane treści to default, domain, drive i allDrives. Aby zapewnić optymalną wydajność, stosuj default lub drive do allDrives.
corpus
(deprecated)

enum (Corpus)

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

string

Identyfikator dysku współdzielonego do wyszukania.
includeItemsFromAllDrives

boolean

Określa, czy w wynikach powinny się znaleźć zarówno elementy z Mojego dysku, jak i z dysku współdzielonego.
includeTeamDriveItems
(deprecated)

boolean

Wycofane: użyj includeItemsFromAllDrives.
maxResults

integer

Maksymalna liczba plików zwracanych na stronę. Częściowe lub puste strony wyników są możliwe nawet przed osiągnięciem listy plików.
orderBy

string

Lista rozdzielonych przecinkami kluczy sortowania. Prawidłowe klucze to createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred, title i title_natural. Każdy klucz jest domyślnie sortowany rosnąco, ale można go cofnąć za pomocą modyfikatora desc. Przykład użycia: ?orderBy=folder,modifiedDate desc,title. Pamiętaj, że w przypadku użytkowników mających około milion plików, w których wymagana kolejność sortowania jest ignorowana, jest bieżące ograniczenie.
pageToken

string

Token strony w plikach.
projection
(deprecated)

enum (Projection)

Wycofany: ten parametr nie ma funkcji.
q

string

Ciąg zapytania dotyczący wyszukiwania plików.
spaces

string

Rozdzielona przecinkami lista pokoi, których ma dotyczyć zapytanie. Obsługiwane wartości to drive i appDataFolder.
supportsAllDrives

boolean

Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone.
supportsTeamDrives
(deprecated)

boolean

Wycofane: użyj supportsAllDrives.
teamDriveId
(deprecated)

string

Wycofane: użyj driveId.
includePermissionsForView

string

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

string

Lista oddzielonych przecinkami identyfikatorów etykiet, które mają zostać dołączone do 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 
{
  "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. Ta pozycja będzie niedostępna, jeśli osiągnięto koniec listy plików. Jeśli z jakiegoś powodu token zostanie odrzucony, należy go podzielić na strony na pierwszej stronie wyników.
kind

string

Zawsze będzie to drive#fileList.
etag

string

ETag listy.
items[]

object (File)

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

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.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 zabezpieczeń, aby można było z nich korzystać. 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.