Ця функція доступна за максимальним тарифом
- Як підготувати Google таблицю
- Як написати json-запит
- Як записати рядки в конкретні стовпці
- Як записати дані в конкретні комірки
- Як видалити записи з конкретних комірок
- Як записати в першу порожню комірку в рядку
- Як прочитати дані з таблиці
- Як знайти текст у таблиці (вивести перший відповідний рядок)
- Як перелічити всі збіги в таблиці
- Як повністю видалити рядок (зі зміщенням)
- Як повністю видалити стовпець (зі зміщенням)
- Як зробити кнопки для вибору аркуша в таблиці
- Як працювати через свій обліковий запис
- Як працювати з літерами стовпців
- Як задавати змінні в назвах стовпців
- Як видалити з таблиці
- Як додати аркуш до таблиці Потенційна помилка Функції Google Table (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"Назва аркуша", 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": "Назва аркуша"} Де 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"просто текст"},"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": "Назва файлу"}
Якщо з запитом немає проблем, буде повернуто назву комірки та її вміст:"{"A1":" привет", "A2":" пра"}" Якщо ви не хочете ризикувати, обмежуючи доступ до вашої таблиці для вашого облікового запису, ви повинні передати параметр creds_path з url вашого файлу даних. Докладніше про це в розділі Робота через ваш обліковий запис:
{"id": "id table", "read"::{"a1":"a3", "b3": "b6"}, "list_name": "Назва аркуша","creds_path": "шлях шлях шлях до вашого файлу даних для авторизації"}