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 klucz domyślnie sortuje dane rosnąco, ale można to zmienić, używając modyfikatora desc. Przykład użycia: ?orderBy=folder,modifiedDate desc,title. Pamiętaj, że aktualnie obowiązuje ograniczenie dotyczące użytkowników liczących około miliona plików, w przypadku których wymagana kolejność sortowania jest ignorowana.

pageToken

string

Token strony dla wydawców podrzędnych.

q

string

Ciąg zapytania do wyszukania 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 następnej strony podrzędnej. Nie będzie on brakujący, jeśli doszło do osiągnięcia końca listy podrzędnej. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go unieważnić, a podział na strony powinien rozpocząć się od nowa na pierwszej stronie wyników.

kind

string

To zawsze drive#childList.

etag

string

Identyfikator ETag listy.

items[]

object (ChildReference)

Lista elementów podrzędnych. Jeśli pole nextPageToken jest wypełnione, ta lista może być niekompletna i powinna zostać pobrana dodatkowa strona z wynikami.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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. Aby można było z nich korzystać, aplikacja musi przeprowadzić ocenę zabezpieczeń. Więcej informacji znajdziesz w przewodniku na temat autoryzacji.