# gws-sheets

Слэш-команда запускает операции Google Sheets через CLI gws: чтение значений, запись строк, создание таблиц и пакетные обновления.

- команда · `type=command` · Claude Code · 77 установок
- Автор: davila7
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/google-workspace/gws-sheets.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/gws-sheets

## Что делает

Команда принимает аргументы в формате `[resource] [method] [flags]` и передаёт их в `gws sheets`. Внутри — обёртка над Sheets API v4: ресурсы `spreadsheets`, `values`, `sheets`, `developerMetadata` и методы вроде `create`, `get`, `batchUpdate`. Есть вспомогательные команды `+read` и `+append` для чтения значений и добавления строки.

Перед вызовом метод стоит посмотреть через `gws schema sheets.<resource>.<method>` — там видно обязательные параметры и типы. Параметры запроса и пути идут во флаг `--params`, тело запроса — в `--json`. Пагинация — через `--max-results` или `--page-token`.

Без установленного `gws` команда не заработает: сначала проверьте `gws --version` и статус авторизации через `gws auth status`. Ещё нужен файл `../gws-shared/SKILL.md` с правилами авторизации и глобальными флагами — если его нет, создайте через `gws generate-skills`. Ошибки квот и авторизации команда не обходит, их придётся разбирать по выводу.

## Требования
- Работает с: Google Workspace

## Установка

### Claude Code (родная платформа)

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --command google-workspace/gws-sheets
```

2. **Вручную: положить файлы**
- Файл: `.claude/commands/gws-sheets.md` — Вызов — /gws-sheets. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/gws-sheets.md` — Вызов — /prompts:gws-sheets. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/gws-sheets.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/gws-sheets.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/commands/google-workspace/gws-sheets.md

## Когда брать
- прочитать диапазон значений из таблицы по ID
- добавить строку в конец листа
- создать новую таблицу и получить её ID
- применить пакет обновлений к нескольким листам
- выбрать подмножество данных через фильтры

## Примеры запросов агенту
- Прочитай значения из таблицы `1AbC...` в диапазоне `Sheet1!A1:D10`
- Добавь строку с итогами в конец листа `Report`
- Создай таблицу с названием `Q3 Budget` и покажи её ID

## Похожие
- [gws-sheets-read](https://affpapa.org/nevibecode/skills/gws-sheets-read.md) — скилл · 50700 установок
- [sheets-cli](https://affpapa.org/nevibecode/skills/sheets-cli.md) — скилл · ★ 72
- [gws-sheets-append](https://affpapa.org/nevibecode/skills/gws-sheets-append.md) — скилл · 46700 установок
- [google-sheets](https://affpapa.org/nevibecode/skills/sanjay3290-google-sheets.md) — скилл · 465 установок
- [google-sheets-mcp](https://affpapa.org/nevibecode/mcp/google-sheets-mcp.md) — MCP-сервер · ★ 13
- [sheets-automation](https://affpapa.org/nevibecode/skills/sheets-automation.md) — скилл · 5200 установок

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 495 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md