Method: children.list
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir klasörün alt öğelerini listeler.
HTTP isteği
GET https://www.googleapis.com/drive/v2/files/{folderId}/children
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
folderId |
string
Klasörün kimliği.
|
Sorgu parametreleri
| Parametreler |
maxResults |
integer
Döndürülecek maksimum alt öğe sayısı.
|
orderBy |
string
Virgülle ayrılmış sıralama anahtarları listesi. Geçerli anahtarlar createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred ve title'dir. Her anahtar varsayılan olarak artan şekilde sıralanır ancak desc değiştiricisiyle tersine çevrilebilir. Kullanım örneği: ?orderBy=folder,modifiedDate desc,title. Yaklaşık bir milyon dosyası olan kullanıcılar için şu anda bir sınırlama olduğunu ve istenen sıralama düzeninin yoksayıldığını lütfen unutmayın.
|
pageToken |
string
Çocuklar için sayfa jetonu.
|
q |
string
Çocukları aramak için kullanılan sorgu dizesi.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Bir dosyanın alt öğelerinin listesi.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
| JSON gösterimi |
{
"items": [
{
object (ChildReference)
}
],
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"nextLink": string
} |
| Alanlar |
items[] |
object (ChildReference)
Çocukların listesi. nextPageToken doldurulmuşsa bu liste eksik olabilir ve ek bir sonuç sayfası getirilmelidir.
|
nextPageToken |
string
Çocukların sonraki sayfası için sayfa jetonu. Çocuk listesinin sonuna ulaşılmışsa bu öğe bulunmaz. Jeton herhangi bir nedenle reddedilirse atılmalı ve sayfalara ayırma işlemi sonuçların ilk sayfasından yeniden başlatılmalıdır.
|
kind |
string
Bu her zaman drive#childList olur.
|
etag |
string
Listenin ETag'i.
|
selfLink |
string
Bu listeye geri dönen bir bağlantı.
|
nextLink |
string
Sonraki çocuk sayfasına bağlantı.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
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
Bazı kapsamlar kısıtlanmıştır ve uygulamanızın bunları kullanabilmesi için güvenlik değerlendirmesi yapılması gerekir. Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# Method: children.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ChildList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists a folder's children.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v2/files/{folderId}/children`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|--------------------------------|\n| `folderId` | `string` The ID of the folder. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` Maximum number of children to return. |\n| `orderBy` | `string` A comma-separated list of sort keys. Valid keys are `createdDate`, `folder`, `lastViewedByMeDate`, `modifiedByMeDate`, `modifiedDate`, `quotaBytesUsed`, `recency`, `sharedWithMeDate`, `starred`, and `title`. Each key sorts ascending by default, but may be reversed with the `desc` modifier. Example usage: ?orderBy=folder,modifiedDate desc,title. Please note that there is a current limitation for users with approximately one million files in which the requested sort order is ignored. |\n| `pageToken` | `string` Page token for children. |\n| `q` | `string` Query string for searching children. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of children of a file.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"items\": [ { object (/workspace/drive/api/reference/rest/v2/children#ChildReference) } ], \"nextPageToken\": string, \"kind\": string, \"etag\": string, \"selfLink\": string, \"nextLink\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `items[]` | `object (`[ChildReference](/workspace/drive/api/reference/rest/v2/children#ChildReference)`)` The list of children. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. |\n| `nextPageToken` | `string` The page token for the next page of children. This will be absent if the end of the children list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. |\n| `kind` | `string` This is always `drive#childList`. |\n| `etag` | `string` The ETag of the list. |\n| `selfLink` | `string` A link back to this list. |\n| `nextLink` | `string` A link to the next page of children. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/docs`\n- `\n https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.photos.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
