gws-sheets-read
Installation
Summary
Read cell values from a Google Sheet by spreadsheet ID and range.
- Requires spreadsheet ID and range specification (e.g.,
Sheet1!A1:D10or entire sheet name) - Read-only operation; never modifies the spreadsheet
- Supports both specific ranges and full sheet reads
- Depends on
gws-sharedfor authentication and global configuration
SKILL.md
sheets +read
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Read values from a spreadsheet
Usage
gws sheets +read --spreadsheet <ID> --range <RANGE>
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--spreadsheet |
✓ | — | Spreadsheet ID |
--range |
✓ | — | Range to read (e.g. 'Sheet1!A1:B2') |
Examples
gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"
gws sheets +read --spreadsheet ID --range Sheet1
Tips
- Read-only — never modifies the spreadsheet.
- For advanced options, use the raw values.get API.
See Also
- gws-shared — Global flags and auth
- gws-sheets — All read and write spreadsheets commands