# GWS Drive Examples & Reference

Load when working with Google Drive.

## List Files

```bash
gws drive files list --params '{"pageSize": 10}'
```

## Search by Name

```bash
gws drive files list --params '{"q": "name contains \"keyword\""}'
```

## Search by MIME Type

```bash
# Find all spreadsheets
gws drive files list --params '{"q": "mimeType=\"application/vnd.google-apps.spreadsheet\""}'

# Find all folders
gws drive files list --params '{"q": "mimeType=\"application/vnd.google-apps.folder\""}'
```

## List Files in a Specific Folder

```bash
gws drive files list --params '{"q": "\"FOLDER_ID\" in parents"}'
```

## Pagination

```bash
# Auto-paginate (NDJSON, one line per page)
gws drive files list --params '{"pageSize": 100}' --page-all

# Limit pages
gws drive files list --params '{"pageSize": 100}' --page-all --page-limit 3
```