Работа с гугл таблицами

Важно! Перед тем как работать с таблицей в ней должна быть шапка или уже какие-то данные записаны.

URL функции: https://store.salebot.pro/function/gsheets

Запись заявок в таблицы
{"id": "ид таблицы", "mapping":{"a":"#{переменная}", "b": "#{еще}", "c": "#{еще}", "d":"просто текст"}}
Где id это id вашей гугл таблицы где хранятся промокоды. Вы можете получить его из ссылки на вашу гугл таблицу. Сама таблица должна быть доступна на редактирование для всех у кого есть ссылка.
https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0
mapping - массив имен колонок и данных, которые туда надо записать. (a, b, c, d - это как раз имена столбцов)
Метод возвращает номер строки, который Вы можете сохранить и использовать для редактирования данных в строке

 

 

Запись данных в таблицу
{"id": "ид таблицы", "write":{"a1":"#{переменная}", "b3": "#{еще}", "c1": "#{еще}", "d20":"просто текст"}}
Где id это id вашей гугл таблицы где хранятся промокоды. Вы можете получить его из ссылки на вашу гугл таблицу. Сама таблица должна быть доступна на редактирование для всех у кого есть ссылка. 

 

Чтение данных их таблицы
{"id": "ид таблицы", "read":{"a1":"a1", "b3": "b4", "c1": "c10", "d20":"a1"}}
Где id это id вашей гугл таблицы где хранятся промокоды. Вы можете получить его из ссылки на вашу гугл таблицу. Сама таблица должна быть доступна на редактирование для всех у кого есть ссылка. Передаются параметрами диапазоны. В примере "a1":"a1" возвращает одну ячейку, а "c1":"c10" 10 значений из колонки c. Возвращаемое значение хеш из адреса ячейки и значения из него.

 

Поиск текста в таблице

URL функции: https://store.salebot.pro/function/findcell

Часто бывает необходимо по ключу найти ответ в таблице и вывести в боте. Примеры использования: поиск наличия на складе товара, отображение стоимость услуги. Важно!!! Нумерация строк и колонок идет с единицы.
Существует четыре способа:
1) Поиск по всей таблице и вывод текста из соседней ячейки
{"id": "ид таблицы", "find": "текст для поиска"}
2) Поиск по колонке и вывод текста из соседней ячейки. Где col номер колонки для поиска.
{"id": "ид таблицы", "find": "текст для поиска", "col": 2}
3) Поиск по колонке и вывод текста из указанной колонки в той же строке. Где return номер колонки для вывода.
{"id": "ид таблицы", "find": "текст для поиска", "col": 2, "return": 4}
4) Поиск по колонке и вывод текста из указанной колонки в той же строке. Параметр return необходимо передать со значением 0.
{"id": "ид таблицы", "find": "текст для поиска", "col": 2, "return": 0}

Функция вернет:
{ "status": 1, "data": "Василий\n+79873238217", "cell_number": { "col": 1, "row": 9 } }
Где status 1 если найдено значение и 0 если нет. data - найденное значение, cell_number - найденная ячейка.
Для случая вывода всей строки, результат будет следующим:
{"status": 1, "data": {"0": "текст первой колонки", "1": "555555", "2": "3", "3": "это четвертая, нумерация с нуля"}, "cell_number": {"row": 4, "col": 2}}

По умолчанию поиск идет на полное совпадение, но вы можете использовать и другие алгоритмы поиска.

Для использования новых алгоритмов поиска нужно, к стандартному вызову, добавить дополнительные параметры.

Добавлено 4 новых алгоритма поиска (‘alg’) по:

1. Левенштейну - ‘L’

2. используя регулярное выражение - ‘R’

3. частичному Левенштейну - ‘PL’

4. по наличию ключевых слов - ‘K’

Регулярное выражение принимает обязательный параметр регулярку:  “value”: “тут ваше регулярное выражение” - ВАЖНО! регулярное выражение необходимо экранировать. перед каждым символом \ необходимо указать такой же \, то есть исходное выражение "^\d\d$" должно выглядеть как "^\\d\\d$" 
Левенштейн и частичный Левенштейн, принимает дополнительный параметр:   “value”: ”95” -  минимальный порог похожести, регистр не учитывается (от 1 до полного совпадения 100, по умолчанию 80). Возвращает наивысшее совпадение.

Примеры

Поиск по Левенштейну, порог вхождения 90 и выше.
1) Поиск по всей таблице и вывод текста из соседней ячейки
{"id": "ид таблицы", "find": "текст для поиска", “alg”: “L”, “value”: “90”} 

Поиск с использованием регулярного выражения
3) Поиск по колонке и вывод текста из указанной колонки в той же строке. Где return номер колонки для вывода.
{"id": "ид таблицы", "col": 2, "return": 4, “alg”: “R”, “value”: “^\\d\\d$”}
Параметр "find": "текст для поиска" в этом режиме поиска не нужен.

 

О том куда это вводить и как с этим работать вы можете прочитать по ссылке.

UPD Для удобства работы с функцией мы добавили возможность выбора листа в таблице и возможность использования своих сервисных данных гугл аккаунта.

Выбор листа в таблице

Для того, осуществить выбор листа в таблице вам нужно воспользоваться вспомогательной функцией sheetchoice

URL функции: https://store.salebot.pro/function/sheetchoice

функция принимает следующие параметры

{

  "id": "как обычно id таблицы",

  "creds_path": "путь к файлу с вашими данными сервисного аккаунта гугл",

  "client_type": "#{client_type}",

  "show": "количество результатов для вывода"

}

где id - это id таблицы с которой вы работаете, creds_path - необязательный параметр путь или урл к вашему файлу содержащиму сервисные данные для авторизации в таблице, client_type - тип мессенджера и show - количество результатов для вывода

После вызова функция вернет массив с кнопками который вы можете использовать для выбора листа или в случае мессенджеров без кнопок функция вернет текстовый выбор названий листов.

Пример ответа функции в случае мессенджеров с кнопками:

{"vibor": "[{\"type\": \"reply\", \"text\": \"22.11.2019\", \"line\": 0, \"index_in_line\": 0}, {\"type\": \"reply\", \"text\": \"20.11.2019\", \"line\": 1, \"index_in_line\": 0}]"}

Пример ответа функции в случае мессенджеров без кнопок:

{"vibor": "0 - 22.11.2019\n1 - 20.11.2019\n"}

сохраните ответ функции в нужную вам переменную например так vibor->vibor и затем в случае использования мессенджера без кнопок выводите ее в блоке с ответом. Или в случае с мессенджера с кнопками вставляйте ее в поле 'расширенные настройки кнопок'.

 

Для выбора листов в функциях gsheets и findcell  передавайте дополнительный параметр list_name. Для использования своих сервисных данных передавайте дополнительный параметр creds_path.

Например при записи в таблицу параметры могут выглядеть так:

{"id": "ид таблицы", "mapping":{"a":"#{переменная}", "b": "#{еще}", "c": "#{еще}", "d":"просто текст"}, "list_name": "имя листа", "creds_path": "путь к вашему файлу с данными для авторизации"}

https://habr.com/ru/post/483302/ - вот здесь есть инструкция как получить свой сервисный аккаунт гугл для работы с таблицами