# 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 -> ваша\_переменная Если приходят сложные параметры, разберите их следующим образом: > "cell\_number":{"row":4,"col":2} cell\_number|row -> Строка; cell\_number|col -> Столбец Теперь разберём подробнее, что делают боты с таблицами Google. ## Как записывать строки в определённые столбцы Вы можете собрать у пользователя много данных и записать их в первую свободную строку в таблице. Это делается с помощью **сопоставления** . {% hint style="warning" %} Заголовок должен быть заполнен (хотя бы одна ячейка в первой строке) {% endhint %} 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 (то, что выделено жирным в ссылке ниже). 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-функции: ; Параметры `{"id": "id таблицы", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{yet}", "d20"просто текст"}}. Запись производится в конкретные ячейки, которые вы указываете (в нашем примере a1, b3, c1, d20)` {% hint style="warning" %} Нумерация столбцов начинается с единицы. {% endhint %} Если нужно записывать строки не на первый лист, следует добавить в запрос параметр 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-функции: ; `{"id": "id таблицы", "remove":[a1", "b3", "c2"]}. Удаляет значения из указанных вами ячеек (в нашем примере a1, b3, c2)` {% hint style="warning" %} Нумерация столбцов начинается с единицы. {% endhint %} Если нужно удалять ячейки не на первом листе, следует добавить в запрос параметр 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-функции: ; Параметры запроса {"id": "id таблицы", "append\_in\_row":"8", "value": "записанное значение"} Если нужно записывать строки не на первый лист, следует добавить параметр list\_name: {"id": "id таблицы", "append\_in\_row":", "value": "значение", "list\_name": "Название листа"} Где id — это id вашей таблицы Google. Его можно взять из ссылки на вашу таблицу Google (то, что выделено жирным в ссылке ниже). 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-функции: {"id": "id таблицы", "read":{"a1":"a1", "b3": "b4", "c1": "c10", "d20":"a1"}} Укажите параметры для передачи диапазонов. В примере "a1":"a1" возвращает одну ячейку, а "c1":"c10" возвращает 10 значений из столбца c. Возвращается хэш-значение из адреса ячейки и значения из неё. {% hint style="warning" %} Нумерация столбцов начинается с единицы. {% endhint %} Если нужно читать значения не с первого листа, следует добавить в запрос параметр 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": "путь путь путь к вашему файлу с данными для авторизации"} --- # 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/ru/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.