Method: children.list
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet die untergeordneten Elemente eines Ordners auf.
HTTP-Anfrage
GET https://www.googleapis.com/drive/v2/files/{folderId}/children
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
folderId |
string
Die ID des Ordners.
|
Abfrageparameter
| Parameter |
maxResults |
integer
Maximale Anzahl der zurückzugebenden untergeordneten Elemente.
|
orderBy |
string
Eine durch Kommas getrennte Liste von Sortierschlüsseln. Gültige Schlüssel sind createdDate, folder, lastViewedByMeDate, modifiedByMeDate, modifiedDate, quotaBytesUsed, recency, sharedWithMeDate, starred und title. Die Sortierung erfolgt standardmäßig aufsteigend nach jedem Schlüssel. Mit dem Modifikator desc kann die Reihenfolge umgekehrt werden. Beispiel: ?orderBy=folder,modifiedDate desc,title. Hinweis: Für Nutzer mit etwa einer Million Dateien gilt derzeit eine Einschränkung, bei der die angeforderte Sortierreihenfolge ignoriert wird.
|
pageToken |
string
Seitentoken für Kinder.
|
q |
string
Abfragestring für die Suche nach Kindern.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste der untergeordneten Elemente einer Datei.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"items": [
{
object (ChildReference)
}
],
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"nextLink": string
} |
| Felder |
items[] |
object (ChildReference)
Die Liste der untergeordneten Elemente. Wenn „nextPageToken“ ausgefüllt ist, ist diese Liste möglicherweise unvollständig und es sollte eine zusätzliche Seite mit Ergebnissen abgerufen werden.
|
nextPageToken |
string
Das Seitentoken für die nächste Seite mit untergeordneten Elementen. Dieser Parameter ist nicht vorhanden, wenn das Ende der Liste der untergeordneten Elemente erreicht wurde. Wenn das Token aus irgendeinem Grund abgelehnt wird, sollte es verworfen und die Paginierung mit der ersten Ergebnisseite neu gestartet werden.
|
kind |
string
Dies ist immer drive#childList.
|
etag |
string
Das ETag der Liste.
|
selfLink |
string
Ein Link zurück zu dieser Liste.
|
nextLink |
string
Ein Link zur nächsten Seite mit untergeordneten Elementen.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
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
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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)."]]
