Method: children.list

フォルダの子を一覧表示します。

HTTP リクエスト

GET https://www.googleapis.com/drive/v2/files/{folderId}/children

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
folderId

string

フォルダの ID。

クエリ パラメータ

パラメータ
maxResults

integer

返される子の最大数。

orderBy

string

並べ替えキーのカンマ区切りのリスト。有効なキーは createdDatefolderlastViewedByMeDatemodifiedByMeDatemodifiedDatequotaBytesUsedrecencysharedWithMeDatestarredtitle です。デフォルトでは、各キーはそれぞれ昇順で表示されますが、desc 修飾子を使用すると逆の順序で並べることもできます。使用例: ?orderBy=folder,modifiedDate desc,title. 現在のところ、ファイルが約 100 万個ある場合、リクエストされた並べ替え順序は無視されます。

pageToken

string

子のページトークン。

q

string

子を検索するためのクエリ文字列。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

ファイルの子のリスト。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "nextPageToken": string,
  "kind": string,
  "etag": string,
  "selfLink": string,
  "nextLink": string,
  "items": [
    {
      object (ChildReference)
    }
  ]
}
フィールド
nextPageToken

string

子の次のページのページトークン。子リストの最後に達している場合は存在しません。なんらかの理由でトークンが拒否された場合は、トークンを破棄し、ページ分けを結果の最初のページから再開する必要があります。

kind

string

これは常に drive#childList です。

etag

string

リストの ETag。

items[]

object (ChildReference)

子のリスト。nextPageToken に値が入力されている場合、このリストは不完全である可能性があり、追加の結果ページを取得する必要があります。

認可スコープ

以下のいずれかの 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

一部のスコープには制限があり、アプリでそれらを使用するにはセキュリティ評価が必要です。詳細については、承認ガイドをご覧ください。