WriteGoogleTable

Что это за реакция

Реакция WriteGoogleTable позволяет боту записывать данные в Google Таблицу.

В сценариях бота, когда нужно:

Режим	Что делает	Когда использовать
Новая строка (по умолчанию)	Добавляет новую строку в конец таблицы	Когда вы добавляете новые записи: новых клиентов, заказы, ответы на опросы
Диапазон	Записывает данные по указанному адресу	Когда нужно записать в конкретное место: обновить ячейку, перезаписать диапазон

Параметр	Что это
Выбор таблицы	В какую таблицу записывать
Режим работы	«Новая строка» или «Диапазон»

Выберите один из двух способов:

Вы выбираете заранее созданный конвертер (шаблон). Бот сам знает, в какие столбцы что записывать.

✅ Плюс: не нужно каждый раз вводить данные вручную.
❌ Минус: нужно создать конвертер заранее.

Вы вводите данные прямо в поле в формате JSON или YAML.

✅ Плюс: гибко, можно записать что угодно.
❌ Минус: нужно знать форматы JSON / YAML.

📌 Когда вы выбираете конвертер, поле для ручного ввода скрывается.

Используется только в режиме «Диапазон» и там обязателен.

Источник данных	Как указывается адрес
Ручные данные	Полный A1-адрес: `A1`, `B2:D5`, `Sheet1!A1`
Конвертер	Только стартовая позиция:
	— при ориентации Rows → номер строки (например, `5`)
	— при ориентации Columns → буква столбца (например, `C`)

Ориентация конвертера	Адрес	Что произойдёт
Rows (строки)	`3`	Запись начнётся с 3-й строки, данные пойдут по столбцам вправо
Columns (столбцы)	`C`	Запись начнётся со столбца C, данные пойдут по строкам вниз

Режим «Новая строка» добавляет только строки. Поэтому:

Ориентация конвертера	Можно ли использовать «Новую строку»
Rows (строки)	✅ Да
Columns (столбцы)	❌ Нет, используйте режим «Диапазон»

Параметр	Варианты	Что делает
ValueInputOption	`USER_ENTERED` (по умолчанию)	Данные интерпретируются как при ручном вводе: `=A1+B1` станет формулой, `1.5` — числом, `01.01.2024` — датой
	`RAW`	Данные сохраняются как есть, без интерпретации
MajorDimension	`ROWS` (по умолчанию)	Данные группируются по строкам
	`COLUMNS`	Данные группируются по столбцам

Одна запись (по порядку столбцов):

["Анна", 22, "anna@example.com"]

Несколько записей:

[["Анна", 22, "anna@example.com"], ["Пётр", 28, "petr@example.com"]]

Одна запись с указанием столбцов:

{"A": "Анна", "B": 22, "C": "anna@example.com"}

Несколько записей с указанием столбцов:

[{"A": "Анна", "B": 22, "D": "anna@example.com"}, {"A": "Пётр", "B": 28, "D": "petr@example.com"}]

Одна запись (по порядку):

- Анна
- 22
- anna@example.com

Несколько записей (по порядку):

- - Анна
  - 22
  - anna@example.com
- - Пётр
  - 28
  - petr@example.com

Одна запись с указанием столбцов:

A: Анна
B: 22
C: anna@example.com

Несколько записей с указанием столбцов:

- A: Анна
  B: 22
  C: anna@example.com
- A: Пётр
  B: 28
  C: petr@example.com