# Google Tables {% hint style="warning" %} Ця функція доступна на максимальному тарифі {% endhint %} * Як підготувати таблицю 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** функцію. {% hint style="warning" %} Заголовок має бути заповнений (принаймні одна комірка в першому рядку) {% endhint %} 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 (те, що виділено жирним у посиланні нижче). 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-функції: ; Параметри `{"id": "id table", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"просто текст"}}. Запис виконується у певні комірки, які ви вказуєте (у нашому прикладі a1, b3, c1, d20)` {% hint style="warning" %} Нумерація стовпців починається з одиниці. {% endhint %} Якщо ви хочете записувати рядки не на перший аркуш, слід додати параметр 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-функції: ; `{"id": "id of the table", "remove":[a1", "b3", "c2"]}. Видаляє значення з певних комірок, які ви вказуєте (у нашому прикладі a1, b3, c2)` {% hint style="warning" %} Нумерація стовпців починається з одиниці. {% endhint %} Якщо ви хочете видаляти комірки з першого аркуша, слід додати параметр 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-функції: ; Параметри запиту {"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 (те, що виділено жирним у посиланні нижче). 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-функції: {"id": "id table", "read":{"a1":"a1", "b3": "b4", "c1": "c10", "d20":"a1"}} Задайте параметри для передавання діапазонів. У прикладі "a1":"a1" повертає одну комірку, а "c1":"c10" повертає 10 значень із стовпця c. Повертається хеш-значення з адреси комірки та значення з неї. {% hint style="warning" %} Нумерація стовпців починається з одиниці. {% endhint %} Якщо ви хочете читати значення не з першого аркуша, слід додати параметр 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": "шлях шлях шлях до вашого файла даних для авторизації"} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/uk/integrations/google/tables.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.