Google Таблицы (Google Sheets)
Чтение и запись листов Google Таблиц в процессах Pailot
Google Таблицы (Google Sheets) — облачные таблицы. Блок читает, пишет, обновляет и дописывает ячейки выбранного листа через OAuth (вход по разрешению сервиса).
С Google Таблицами в Pailot вы можете:
- Читать диапазон ячеек листа (по умолчанию
A1:Z1000)
- Записывать и обновлять значения в диапазоне
- Дописывать строки в конец листа (
OVERWRITE или INSERT_ROWS)
Блок ставят на холст как отдельный шаг или прикрепляют к агенту. Секреты — в переменных окружения рабочего пространства.
Прочитать данные листа.
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы |
sheetName | string | Да | Имя листа |
cellRange | string | Нет | Диапазон (например, A1:D10). По умолчанию A1:Z1000 |
| Параметр | Тип | Описание |
|---|
sheetName | string | Имя прочитанного листа |
range | string | Прочитанный диапазон |
values | array | Значения ячеек — двумерный массив |
metadata | json | Метаданные: ID и URL таблицы |
↳ spreadsheetId | string | ID таблицы |
↳ spreadsheetUrl | string | URL таблицы |
Записать данные на лист.
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы |
sheetName | string | Да | Имя листа |
cellRange | string | Нет | Диапазон (например, A1:D10, A1). По умолчанию A1 |
values | array | Да | Данные: двумерный массив (например, [["Name", "Age"], ["Alice", 30]]) или массив объектов |
valueInputOption | string | Нет | Формат записываемых данных |
includeValuesInResponse | boolean | Нет | Вернуть записанные значения в ответе |
| Параметр | Тип | Описание |
|---|
updatedRange | string | Обновлённый диапазон |
updatedRows | number | Сколько строк обновлено |
updatedColumns | number | Сколько столбцов обновлено |
updatedCells | number | Сколько ячеек обновлено |
metadata | json | Метаданные: ID и URL таблицы |
↳ spreadsheetId | string | ID таблицы |
↳ spreadsheetUrl | string | URL таблицы |
Обновить данные листа.
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы |
sheetName | string | Да | Имя листа |
cellRange | string | Нет | Диапазон (например, A1:D10, A1). По умолчанию A1 |
values | array | Да | Данные: двумерный массив (например, [["Name", "Age"], ["Alice", 30]]) или массив объектов |
valueInputOption | string | Нет | Формат данных |
includeValuesInResponse | boolean | Нет | Вернуть обновлённые значения в ответе |
| Параметр | Тип | Описание |
|---|
updatedRange | string | Обновлённый диапазон |
updatedRows | number | Сколько строк обновлено |
updatedColumns | number | Сколько столбцов обновлено |
updatedCells | number | Сколько ячеек обновлено |
metadata | json | Метаданные: ID и URL таблицы |
↳ spreadsheetId | string | ID таблицы |
↳ spreadsheetUrl | string | URL таблицы |
Дописать данные в конец листа.
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы |
sheetName | string | Да | Имя листа |
values | array | Да | Данные: двумерный массив (например, [["Alice", 30], ["Bob", 25]]) или массив объектов |
valueInputOption | string | Нет | Формат данных |
insertDataOption | string | Нет | Как вставлять: OVERWRITE или INSERT_ROWS |
includeValuesInResponse | boolean | Нет | Вернуть дописанные значения в ответе |
| Параметр | Тип | Описание |
|---|
tableRange | string | Диапазон таблицы, куда дописали |
updatedRange | string | Обновлённый диапазон |
updatedRows | number | Сколько строк обновлено |
updatedColumns | number | Сколько столбцов обновлено |
updatedCells | number | Сколько ячеек обновлено |
metadata | json | Метаданные: ID и URL таблицы |
↳ spreadsheetId | string | ID таблицы |
↳ spreadsheetUrl | string | URL таблицы |
