Эта функция доступна на максимальном тарифе
- Как подготовить Google таблицу
- Как написать json-запрос
- Как записать строки в определенные столбцы
- Как записать данные в определенные ячейки
- Как удалить записи из определенных ячеек
- Как записать в первую пустую ячейку строки
- Как прочитать данные из таблицы
- Как найти текст в таблице (вывести первую подходящую строку)
- Как вывести все совпадения в таблице
- Как полностью удалить строку (со смещением)
- Как полностью удалить столбец (со смещением)
- Как сделать кнопки для выбора листа в таблице
- Как работать через свой аккаунт
- Как работать с буквами столбцов
- Как задавать переменные в именах столбцов
- Как удалить из таблицы
- Как добавить лист в таблицу Возможная ошибка Функции Google Таблиц (API)
В этой статье рассмотрим, как боты могут взаимодействовать с Google таблицами.
Для использования этой функциональности вам понадобится:
- Google таблица, открытая для редактирования по ссылке
- URL-функция
- Параметры запроса
Как подготовить Google таблицу
!!!
!!!
!!!
Как написать json-запрос
Перейдите в настройки блока, в который будем записывать. Выберите тип POST-json запроса, вставьте URL нужной функции, вставьте параметры в поле JSON POST-параметры (Рисунок 5)
Чтобы увидеть, какой ответ приходит на ваш запрос, напишите в поле Ответ {custom_answer}, сохраните и пройдите по цепочке. Далее вы можете сохранить каждое значение ответа в переменные в поле Сохранить значение из JSON-ответа, используя синтаксис:
parameters_from_query -> your_variable Если приходят сложные параметры, то разбирайте их следующим образом:
"cell_number":{"row":4,"col":2} cell_number|row -> Row; cell_number|col -> Column
Теперь подробнее разберем, что боты делают с Google таблицами.
Как записать строки в определенные столбцы
Вы можете собрать много данных от пользователя и записать их в первую свободную строку таблицы. Это делается с помощью функции mapping.
Заголовок должен быть заполнен (хотя бы одна ячейка в первой строке)
URL-функции: https://store.salebot.pro/function/gsheets
Параметры запроса {"id": "id table", "mapping":{"a"::"#{variable}", "b": "#{yet}", "c": "#{yet}", "d":"just text"}}}
Если вы хотите записывать строки не на первом листе, добавьте параметр list_name в запрос:
{"id": "id table", "mapping":{"a":"just text", "b": "#{variable}"}, "list_name": "Sheet name"}
Где id — это id вашей Google таблицы. Вы можете получить его из ссылки на вашу Google таблицу (что выделено жирным в ссылке ниже). https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0
a, b, c, d — это просто имена столбцов list_name — имя вашего листа (например, "Файл 2")
Если с выполнением запроса нет проблем, приходит ответ {"number_row":8}. Вы можете сохранить этот номер строки и использовать его для дальнейшей работы.
Если вы не хотите рисковать, ограничивая доступ к вашей таблице для вашего аккаунта, вы должны передать параметр creds_path из url вашего файла данных.
Подробнее об этом в разделе Работа через свой аккаунт:
{"id": "id table", "mapping":{"a"::"#{variable}", "b": "#{yet}", "c": "#{yet}", "d":just text"creds_": "path"way to your data file for authorization"}}
Как записать данные в определенные ячейки
URL-функции: https://store.salebot.pro/function/gsheets
Параметры {"id": "id table", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"just text"}}. Запись производится в конкретные ячейки, которые вы указываете (в нашем примере a1, b3, c1, d20)
Нумерация столбцов начинается с единицы.
Если вы хотите записывать строки не на первом листе, добавьте параметр list_name в запрос:
{"id": "id table", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"just text"}, "list_name": "Имя файла"}}
Если с запросом нет проблем, параметры не возвращаются.
Если вы не хотите рисковать, ограничивая доступ к вашей таблице для вашего аккаунта, вы должны передать параметр creds_path из url вашего файла данных.
Подробнее об этом в разделе Работа через свой аккаунт:
{"id": "id table", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{more}", "d20"just text}, "cred_name"Sheet name", s_"path": Путь к вашему файлу данных с авторизацией}
!!!
Как удалить записи из определенных ячеек
URL-функции: https://store.salebot.pro/function/gsheets
{"id": "id of the table", "remove":[a1", "b3", "c2"]}. Удаляет значения из конкретных ячеек, которые вы указываете (в нашем примере a1, b3, c2)
Нумерация столбцов начинается с единицы.
Если вы хотите удалить ячейки с первого листа, добавьте параметр list_name в запрос:
{"id": "id of the table", "remove":[a1", "b3", "c2"], "list_name": "Имя файла"}
Если с запросом нет проблем, параметры не возвращаются.
Если вы не хотите рисковать, ограничивая доступ к вашей таблице для вашего аккаунта, вы должны передать параметр creds_path из url вашего файла данных. Подробнее об этом в разделе Работа через свой аккаунт:
{"id": "table id", "remove":[a1", "b3", "c2"], "list_name": "Имя файла","creds_path": "Путь к вашему файлу данных для авторизации"}
Как записать в первую пустую ячейку строки
Вы можете записать данные в указанную строку, запись произойдет в пустую ячейку справа от последней заполненной ячейки. Это выполняется с помощью функции append_in_row.
URL-функции: https://store.salebot.pro/function/gsheets
Параметры запроса {"id": "table id", "append_in_row":"8", "value": "written value"}
Если вы хотите записывать строки не на первом листе, добавьте параметр list_name: {"id": "id of the table", "append_in_row":", "value": "value", "list_name": "Name of the sheet"} Где id — это id вашей Google таблицы. Вы можете получить его из ссылки на вашу Google таблицу (что выделено жирным в ссылке ниже). https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0
append_in_row — номер строки для записи
value — значение, которое будет записано в ячейку
Если с выполнением запроса нет проблем, приходит ответ {"number_col":10,"col_name":"J3"}. Вы можете сохранить эти номера и использовать их для дальнейшей работы.
Если вы не хотите рисковать, ограничивая доступ к вашей таблице для вашего аккаунта, вы должны передать параметр creds_path из url вашего файла данных. Для получения дополнительной информации см. Работа через свой аккаунт: {"id": "id table", "mapping":"{"a":"#{variable}", "b": "#{more}", "c": "#{more}, "cred"simply text"},"s_": path to your data with"path}"
Как прочитать данные из таблицы
URL-функции: https://store.salebot.pro/function/gsheets
{"id": "id table", "read":{"a1":"a1", "b3": "b4", "c1": "c10", "d20":"a1"}} Установите параметры для передачи диапазонов. В примере "a1":"a1" возвращает одну ячейку, а "c1":"c10" возвращает 10 значений из столбца c. Возвращается хеш-значение из адреса ячейки и значений из нее.
Нумерация столбцов начинается с единицы.
Если вы хотите прочитать значения не на первом листе, добавьте параметр list_name в запрос:
{"id": "id table", "read"::{"a1":"a3", "b3": "b6"}, "list_name": "Имя файла"}
Если с запросом нет проблем, будет возвращено имя ячейки и ее содержимое:"{"A1":" u043f u0440 u0438 u0432 u0435", "A2":" u043f u0440 u0430"U043U0A"U0A0430." U0440A0A"U0A0430." u0444 u0443 u043d u043a u0446"} Если вы не хотите рисковать, ограничивая доступ к вашей таблице для вашего аккаунта, вы должны передать параметр creds_path из url вашего файла данных. Подробнее об этом в разделе Работа через свой аккаунт:
{"id": "id table", "read"::{"a1":"a3", "b3": "b6"}, "list_name": "Имя листа","creds_path": "путь путь путь к вашему файлу данных для авторизации"}