Method: children.list

Wyświetla podfoldery folderu.

Żądanie HTTP

GET https://www.googleapis.com/drive/v2/files/{folderId}/children

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
folderId

string

Identyfikator folderu.

Parametry zapytania

Parametry
maxResults

integer

Maksymalna liczba elementów potomnych do zwrócenia.

orderBy

string

Lista kluczy sortowania rozdzielona przecinkami. Prawidłowe klucze to createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starredtitle. Każdy klucz jest domyślnie sortowany w kolejności rosnącej, ale można to zmienić za pomocą modyfikatora desc. Przykład użycia: ?orderBy=folder,modifiedDate desc,title. Pamiętaj, że obecnie obowiązuje ograniczenie dla użytkowników, którzy mają około miliona plików, w przypadku których ignorowany jest żądany porządek sortowania.

pageToken

string

Token strony dla dzieci.

q

string

Ciąg zapytania do wyszukiwania dzieci.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista elementów podrzędnych pliku.

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

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

string

Token strony dla następnej strony z dziećmi. Nie będzie widoczny, jeśli osiągnięto koniec listy elementów podrzędnych. Jeśli token zostanie odrzucony z jakiegokolwiek powodu, należy go odrzucić i ponowić pobieranie stron od pierwszej strony wyników.

kind

string

Jest ona zawsze drive#childList.

etag

string

ETag listy.

items[]

object (ChildReference)

Lista dzieci. Jeśli parametr nextPageToken jest wypełniony, lista może być niekompletna i należy pobrać kolejną 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.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 z nich korzystać. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.