Робота з таблицями MaviBot

Створити новий запис у таблиці з указаними значеннями

Створити новий запис у таблиці з указаними значеннями.

new_record(table_id, data)

Параметри

Опис

table_id

ID таблиці

data

словник із даними, які потрібно записати. Приклад: {"column_name1": "value1", "column_name2": "value2"}. Якщо стовпець не існує, його буде створено.

Відповідь: ID нового запису

Приклад

Редагувати наявний запис у таблиці

edit_record(table_id, record_id, data)

Параметри

Опис

table_id

ID таблиці

record_id

ID відредагованого запису

data

словник із даними, які потрібно відредагувати. Приклад: {"column_name1": "value3", "column_name2": "value4"}. Якщо стовпець не існує, він НЕ створюється.

Відповідь:

Повертає повні дані відредагованого запису у форматі: {"column_name1": "value3", "column_name2": "value4"}.

Приклад

Видалити запис із таблиці за його ID

delete_record(table_id, record_id)

Параметри

Опис

table_id

ID таблиці

record_id

ID видаленого запису

Відповідь:

{'message': 'Видалено записів: 1'}

Знайти запис у таблиці за вказаним значенням

find_record(table_id, value, find_in, return_from)

Параметри

Опис

table_id

ID таблиці

value

значення для зіставлення

find_in -

необов’язковий параметр. Назва стовпця, за яким виконувати пошук. Якщо не вказано, пошук буде виконано по всіх стовпцях.

return_from

необов’язковий параметр. Назва стовпця, з якого потрібно повернути значення.

Відповідь:

Якщо return_from вказано, буде повернено значення з указаного стовпця (якщо він існує в таблиці). Якщо return_from не вказано або стовпець не існує, у відповіді буде повернуто повні дані знайденого запису, наприклад: {"column_name1": "value3", "column_name2": "value4"}.

Приклад

Отримання значення з указаного запису

get_record_data(table_id, record_id)

Параметри

Опис

table_id

ID таблиці

record_id

ID запису, з якого отримуються значення

return_column

необов’язковий параметр. Назва стовпця, з якого слід повернути значення.

Відповідь: якщо запис знайдено, повертається словник на кшталт {"column_name1": "value1", "column_name2": "value2"}. Якщо вказано параметр return_column і такий стовпець існує, буде повернуто лише значення з цього стовпця.

Де я можу знайти ID таблиці?

Щоб працювати з функціями чатбота, вам знадобиться ID таблиці. Знайдіть потрібну таблицю в списку та натисніть на неї.

Далі натисніть на адресний рядок.

В адресному рядку ви побачите URL на кшталт https://salebot.pro/projects/11111/table/2, де можна знайти ID потрібної таблиці:

Отримання запису з таблиці

get_records_from_table(table_id, start_row, count, start_col, end_col) - отримання запису з таблиці.

Параметр

Опис

Примітка

table_id

ID таблиці

start_row

Необов’язковий параметр, ціле число. Вказує початок діапазону рядків.

Номер рядка, з якого почати читання (включно). Пишіть без лапок.

count

Необов’язковий параметр, ціле число. Вказує кількість рядків для отримання.

За замовчуванням значення — 1000, максимум — 5000. Вказуйте без лапок.

start_col

Необов’язковий параметр, рядок. Вказує початок діапазону стовпців.

Назва стовпця, з якого почати читання (включно). Пишіть у лапках.

end_col

Необов’язковий параметр, рядок. Вказує кінець діапазону стовпців.

Назва стовпця, до якого читати значення таблиці (включно). Пишіть у лапках.

Якщо ви вкажете лише початок діапазону рядків або стовпців, будуть повернуті всі дані від цієї точки й далі. Ви також можете не вказувати початок і зазначити лише кінець, щоб отримати дані до цієї точки.

Приклад

У блоці, де потрібно отримати записи з таблиці, перейдіть до "Калькулятор" розділу в налаштуваннях блока та введіть функцію з потрібними параметрами.

Давайте подивимося, як дані відображаються в таблиці.

Тепер виконайте блок "Start" у тестовому режимі.

Ми бачимо дані, які були записані в змінну з таблиці, у повідомленні, надісланому ботом. Оскільки ми посилалися на змінну в повідомленні за допомогою #{} синтаксису, дані, що зберігалися в ній, відобразилися в чаті бота.

Отримати дані з таблиці в межах указаного діапазону

table_read_cells(table_id, cell_data) - дає змогу отримувати дані з таблиці, вказуючи діапазони.

Параметр

Опис

! table_id

обов’язковий параметр, ID таблиці

! cell_data

обов’язковий параметр, словник із діапазонами. cell_data приклад: '{"a1":"a1", "a3": "b4", "c1": "c3"}'

Якщо під час запиту не виникло жодних проблем, відповідь буде словником, що містить статус і всі комірки з їхніми значеннями:

{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd"або, у разі помилки: {"status": false, "err": "Повідомлення або опис помилки"}