Google Tables
Все возможности взаимодействия бота с Google-таблицами.
Эта функция доступна на максимальном тарифе
Как подготовить таблицу Google
Как написать JSON-запрос
Как записывать строки в определённые столбцы
Как записывать данные в определённые ячейки
Как удалять записи из определённых ячеек
Как записывать в первую пустую ячейку в строке
Как читать данные из таблицы
Как найти текст в таблице (вывести первую подходящую строку)
Как вывести все совпадения в таблице
Как полностью удалить строку (со смещением)
Как полностью удалить столбец (со смещением)
Как сделать кнопки для выбора листа в таблице
Как работать через свой аккаунт
Как работать с буквами столбцов
Как задавать переменные в названиях столбцов
Как удалять из таблицы
Как добавить лист в таблицу Возможная ошибка Функции таблиц Google (API)
В этой статье рассмотрим, как боты могут взаимодействовать с таблицами Google.
Чтобы использовать этот функционал, вам нужно:
Таблица Google, открытая для редактирования по ссылке
URL-функция
Параметры запроса
Как подготовить таблицу Google
!!!
!!!
!!!
Как написать JSON-запрос
Перейдите в настройки блока, в котором будем записывать. Выберите тип POST-json-запроса, вставьте URL нужной нам функции, вставьте параметры в поле JSON POST-параметров (рисунок 5)
Чтобы увидеть, какой ответ приходит на ваш запрос, в поле Ответ {custom_answer} напишите, сохраните и пройдите цепочку. Далее можно сохранить каждое значение ответа в переменные в поле Сохранить значение из JSON-ответа, используя синтаксис:
parameters_from_query -> ваша_переменная Если приходят сложные параметры, разберите их следующим образом:
"cell_number":{"row":4,"col":2} cell_number|row -> Строка; cell_number|col -> Столбец
Теперь разберём подробнее, что делают боты с таблицами Google.
Как записывать строки в определённые столбцы
Вы можете собрать у пользователя много данных и записать их в первую свободную строку в таблице. Это делается с помощью сопоставления .
Заголовок должен быть заполнен (хотя бы одна ячейка в первой строке)
URL-функции: https://store.salebot.pro/function/gsheets
Параметры запроса {"id": "id таблицы", "mapping":{"a"::"#{variable}", "b": "#{yet}", "c": "#{yet}", "d":"просто текст"}}}
Если нужно записывать строки не на первый лист, следует добавить в запрос параметр list_name:
{"id": "id таблицы", "mapping":{"a":"просто текст", "b": "#{variable}"}, "list_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 таблицы", "mapping":{"a"::"#{variable}", "b": "#{yet}", "c": "#{yet}", "d":просто текст"creds_": "путь"к вашему файлу с данными для авторизации"}}
Как записывать данные в определённые ячейки
URL-функции: https://store.salebot.pro/function/gsheets
Параметры {"id": "id таблицы", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"просто текст"}}. Запись производится в конкретные ячейки, которые вы указываете (в нашем примере a1, b3, c1, d20)
Нумерация столбцов начинается с единицы.
Если нужно записывать строки не на первый лист, следует добавить в запрос параметр list_name:
{"id": "id таблицы", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"просто текст"}, "list_name": "Имя файла"}}
Если с выполнением запроса нет проблем, параметры не возвращаются.
Если не хотите рисковать, ограничивая доступ к таблице только своим аккаунтом, нужно передать параметр creds_path из url вашего файла с данными.
Подробнее об этом в разделе Работа через свой аккаунт:
{"id": "id таблицы", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{more}", "d20"просто текст}, "cred_name"Имя листа", s_"path": Путь к вашему файлу с данными для авторизации}
!!!
Как удалять записи из определённых ячеек
URL-функции: https://store.salebot.pro/function/gsheets
{"id": "id таблицы", "remove":[a1", "b3", "c2"]}. Удаляет значения из указанных вами ячеек (в нашем примере a1, b3, c2)
Нумерация столбцов начинается с единицы.
Если нужно удалять ячейки не на первом листе, следует добавить в запрос параметр list_name:
{"id": "id таблицы", "remove":[a1", "b3", "c2"], "list_name": "Имя файла"}
Если с выполнением запроса нет проблем, параметры не возвращаются.
Если не хотите рисковать, ограничивая доступ к таблице только своим аккаунтом, нужно передать параметр creds_path из url вашего файла с данными. Подробнее об этом в разделе Работа через свой аккаунт:
{"id": "id таблицы", "remove":[a1", "b3", "c2"], "list_name": "Имя файла","creds_path": "Путь к вашему файлу с данными для авторизации"}
Как записывать в первую пустую ячейку в строке
Можно записывать данные в указанную строку; запись произойдёт в пустую ячейку справа от последней заполненной ячейки. Это выполняется с помощью функции append_in_row.
URL-функции: https://store.salebot.pro/function/gsheets
Параметры запроса {"id": "id таблицы", "append_in_row":"8", "value": "записанное значение"}
Если нужно записывать строки не на первый лист, следует добавить параметр list_name: {"id": "id таблицы", "append_in_row":", "value": "значение", "list_name": "Название листа"} Где 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 таблицы", "mapping":"{"a":"#{variable}", "b": "#{more}", "c": "#{more}, "cred"просто текст"},"s_": путь к вашим данным с"path}"
Как читать данные из таблицы
URL-функции: https://store.salebot.pro/function/gsheets
{"id": "id таблицы", "read":{"a1":"a1", "b3": "b4", "c1": "c10", "d20":"a1"}} Укажите параметры для передачи диапазонов. В примере "a1":"a1" возвращает одну ячейку, а "c1":"c10" возвращает 10 значений из столбца c. Возвращается хэш-значение из адреса ячейки и значения из неё.
Нумерация столбцов начинается с единицы.
Если нужно читать значения не с первого листа, следует добавить в запрос параметр list_name:
{"id": "id таблицы", "read"::{"a1":"a3", "b3": "b6"}, "list_name": "Имя файла"}
Если с выполнением запроса нет проблем, будет возвращено имя ячейки и её содержимое:"{"A1":" привет", "A2":" пра"U043U0A"U0A0430." U0440A0A"U0A0430." уфункц"} Если не хотите рисковать, ограничивая доступ к таблице только своим аккаунтом, нужно передать параметр creds_path из url вашего файла с данными. Подробнее об этом в разделе Работа через свой аккаунт:
{"id": "id таблицы", "read"::{"a1":"a3", "b3": "b6"}, "list_name": "Имя листа","creds_path": "путь путь путь к вашему файлу с данными для авторизации"}
Последнее обновление