gws-sheets-read

1# sheets +read
2 
3> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.
4 
5Read values from a spreadsheet
6 
7## Usage
8 
9```bash
10gws sheets +read --spreadsheet <ID> --range <RANGE>
11```
12 
13## Flags
14 
15| Flag | Required | Default | Description |
16|------|----------|---------|-------------|
17| `--spreadsheet` | ✓ | — | Spreadsheet ID |
18| `--range` | ✓ | — | Range to read (e.g. 'Sheet1!A1:B2') |
19 
20## Examples
21 
22```bash
23gws sheets +read --spreadsheet ID --range "Sheet1!A1:D10"
24gws sheets +read --spreadsheet ID --range Sheet1
25```
26 
27## Tips
28 
29- Read-only — never modifies the spreadsheet.
30- For advanced options, use the raw values.get API.
31 
32## See Also
33 
34- [gws-shared](../gws-shared/SKILL.md) — Global flags and auth
35- [gws-sheets](../gws-sheets/SKILL.md) — All read and write spreadsheets commands