# Google Sheets

Таблицы Google — листы, ячейки, диапазоны

## Сценарии

### Готовый отчёт в таблице
Агент соберёт цифры, заведёт лист и запишет отчёт диапазонами — с шапкой, автошириной колонок и подсветкой значений выше порога.

### Ответы по данным листа
Агент прочитает нужные листы и диапазоны и ответит на вопрос по цифрам, не заставляя открывать файл и листать вкладки.

### Дозапись итогов по расписанию
Агент допишет строку с итогами дня в конец сводного листа по расписанию, не трогая то, что уже внесено руками выше.

### Сверка двух листов
Агент сопоставит два диапазона по ключу, соберёт расхождения на отдельный лист и отсортирует их по величине разницы.

## Как подключить

### Войдите в аккаунт Google, где лежат таблицы
Откройте sheets.google.com и проверьте, что нужные файлы видны именно под этим аккаунтом. Доступ выдаётся одному аккаунту, и агент увидит ровно те таблицы, которые видит он.

### Получите роль «Редактор» на чужие таблицы
Если файл создал коллега, попросите его нажать «Открыть доступ» и добавить ваш адрес с ролью «Редактор». На ролях «Читатель» и «Комментатор» агент только читает: запись в ячейки и добавление строк не пройдут.

### Переведите файлы Excel в формат Google Таблиц
Загруженный .xlsx открывается в браузере, но по API не читается и отдаёт ошибку. Откройте такой файл и выберите «Файл» → «Сохранить как таблицу Google», дальше работайте с полученной копией.

### Снимите запрет администратора Workspace
В корпоративном домене сторонние приложения бывают заблокированы. Администратор в консоли открывает «Безопасность» → «Контроль доступа и данных» → «Управление API» и присваивает приложению статус «Доверенное».

## Частые вопросы

### Как подключить Google Sheets?
Входом в аккаунт Google в отдельном окне: вы подтверждаете доступ к таблицам, копировать ключи не нужно. Агент увидит ровно те файлы, что видит этот аккаунт, поэтому чужие таблицы попросите открыть кнопкой «Открыть доступ» с ролью «Редактор».

### Что агент видит в таблицах?
Листы, диапазоны и значения ячеек той таблицы, ссылку на которую вы дали. Списка файлов у Sheets API нет, поэтому таблица адресуется только ссылкой или идентификатором из неё.

### Пишет ли агент в таблицу?
Да: перезаписывает диапазоны, дописывает строки в конец листа, очищает ячейки, добавляет и переименовывает листы, ставит форматирование, сортировку и условные правила.

### Почему не читается загруженный Excel?
Файл .xlsx открывается в браузере, но по API не читается и отдаёт ошибку. Откройте его и выберите «Файл» → «Сохранить как таблицу Google» — дальше агент работает с полученной копией.

[Открыть Google Sheets](https://sheets.google.com)