Google Tables
Усі можливості взаємодії бота з Google-таблицями.
Ця функція доступна на максимальному тарифі
Як підготувати таблицю 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":"просто текст"}}}
Якщо ви хочете записувати рядки не на перший аркуш, слід додати параметр list_name до запиту:
{"id": "id table", "mapping":{"a":"просто текст", "b": "#{variable}"}, "list_name": "Назва аркуша"}
Де id — це ідентифікатор вашої таблиці Google. Його можна взяти з посилання на вашу таблицю Google (те, що виділено жирним у посиланні нижче). https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0
a, b, c, d — це просто назви стовпців; list_name — назва вашого аркуша (наприклад, «File 2»)
Якщо з виконанням запиту немає проблем, відповідь приходить {"number_row":8}. Ви можете зберегти номер цього рядка і використовувати його для подальшої роботи.
Якщо ви не хочете ризикувати, обмежуючи доступ до вашої таблиці своїм обліковим записом, потрібно передати параметр creds_path з URL вашого файла даних.
Докладніше про це в розділі Робота через свій обліковий запис:
{"id": "id table", "mapping":{"a"::"#{variable}", "b": "#{yet}", "c": "#{yet}", "d": просто текст"creds_": "шлях" до вашого файла даних для авторизації"}}
Як записувати дані у певні комірки
URL-функції: https://store.salebot.pro/function/gsheets
Параметри {"id": "id table", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"просто текст"}}. Запис виконується у певні комірки, які ви вказуєте (у нашому прикладі a1, b3, c1, d20)
Нумерація стовпців починається з одиниці.
Якщо ви хочете записувати рядки не на перший аркуш, слід додати параметр list_name до запиту:
{"id": "id table", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"просто текст"}, "list_name": "Назва файла"}}
Якщо з виконанням запиту немає проблем, параметри не повертаються.
Якщо ви не хочете ризикувати, обмежуючи доступ до вашої таблиці своїм обліковим записом, потрібно передати параметр creds_path з URL вашого файла даних.
Докладніше про це в розділі Робота через свій обліковий запис:
{"id": "id table", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{more}", "d20"просто текст}, "cred_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": "File name"}
Якщо з виконанням запиту немає проблем, параметри не повертаються.
Якщо ви не хочете ризикувати, обмежуючи доступ до вашої таблиці своїм обліковим записом, потрібно передати параметр creds_path з URL вашого файла даних. Докладніше про це в розділі Робота через свій обліковий запис:
{"id": "table id", "remove":[a1", "b3", "c2"], "list_name": "File 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 — це ідентифікатор вашої таблиці 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"просто текст"},"s_": шлях до ваших даних з"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": "File 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": "шлях шлях шлях до вашого файла даних для авторизації"}
Last updated