Method: children.list

Wyświetla listę elementów podrzędnych 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 podrzędnych do zwrócenia.

orderBy

string

Rozdzielona przecinkami lista kluczy sortowania. Prawidłowe klucze to createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred i title. Każdy klawisz domyślnie sortuje się rosnąco, ale można to zmienić za pomocą modyfikatora desc. Przykład użycia: ?orderBy=folder,modifiedDate desc,title. Obecnie obowiązuje ograniczenie dla użytkowników posiadających około miliona plików, w których żądana kolejność sortowania jest ignorowana.

pageToken

string

Token strony dla wydawców podrzędnych.

q

string

Ciąg zapytania do wyszukiwania elementów podrzędnych.

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 następnej strony podrzędnej. Ta wartość nie będzie widoczna po osiągnięciu końca listy elementów podrzędnych. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go odrzucić i uruchomić ponownie podział na strony na pierwszej stronie wyników.

kind

string

Jest to zawsze drive#childList.

etag

string

Wartość ETag listy.

items[]

object (ChildReference)

Lista dzieci. Jeśli wartość NextPageToken jest wypełniona, ta 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.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ą objęte ograniczeniami, a aplikacja może z nich korzystać dopiero po sprawdzeniu zabezpieczeń. Więcej informacji znajdziesz w przewodniku po autoryzacji.