Method: children.list
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
HTTP リクエスト
GET https://www.googleapis.com/drive/v2/files/{folderId}/children
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
folderId |
string
フォルダの ID。
|
クエリ パラメータ
パラメータ |
maxResults |
integer
返す子要素の最大数。
|
orderBy |
string
並べ替えキーのカンマ区切りのリスト。有効なキーは、createdDate 、folder 、lastViewedByMeDate 、modifiedByMeDate 、modifiedDate 、quotaBytesUsed 、recency 、sharedWithMeDate 、starred 、title です。各キーはデフォルトで昇順に並べ替えられますが、desc 修飾子で逆順に並べ替えることもできます。使用例: ?orderBy=folder,modifiedDate desc,title。なお、現在、約 100 万個のファイルがあるユーザーについては、リクエストされた並べ替え順序が無視されるという制限があります。
|
pageToken |
string
お子様のページトークン。
|
q |
string
子を検索するためのクエリ文字列。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
ファイルの子のリスト。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
{
"items": [
{
object (ChildReference )
}
],
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"nextLink": string
} |
フィールド |
items[] |
object (ChildReference )
子どものリスト。nextPageToken が入力されている場合、このリストは不完全である可能性があり、結果の追加ページを取得する必要があります。
|
nextPageToken |
string
子どもの次のページのページトークン。子リストの末尾に達した場合は、これが存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、結果の最初のページからページネーションを再開する必要があります。
|
kind |
string
これは常に drive#childList です。
|
etag |
string
リストの ETag。
|
selfLink |
string
このリストに戻るリンク。
|
nextLink |
string
子どもの次のページへのリンク。
|
認可スコープ
次の 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
一部のスコープは制限されており、アプリでそれらを使用するにはセキュリティ評価が必要です。詳しくは、承認ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 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)."]]