Кестеде көрсетілген мәндермен жаңа жазба жасау
Кестеде көрсетілген мәндермен жаңа жазба жасаңыз.
new_record(table_id, data)
Жауап: жаңа жазба идентификаторы
Мысал
Кестедегі бар жазбаны өңдеу
edit_record(table_id, record_id, data)
Жауап:
Өңделген жазбаның толық деректерін келесі форматта қайтарады: {"column_name1": "value3", "column_name2": "value4"}.
Мысал
Кестеден жазбаны оның идентификаторы бойынша жою
delete_record(table_id, record_id)
Жауап:
{'message': 'Deleted records: 1'}
Кестеде көрсетілген мән бойынша жазбаны табу
find_record(table_id, value, find_in, return_from)
Жауап:
Егер return_from көрсетілсе, көрсетілген бағаннан мән қайтарылады (егер ол кестеде болса). Егер return_from көрсетілмесе немесе баған жоқ болса, жауапта табылған жазбаның толық деректері қайтарылады, мысалы: {"column_name1": "value3", "column_name2": "value4"}.
Мысал
Көрсетілген жазбадан мәнді алу
get_record_data(table_id, record_id)
Жауап: Егер жазба табылса, {"column_name1": "value1", "column_name2": "value2"} сияқты сөздік қайтарылады. Егер return_column параметрі берілсе және мұндай баған болса, тек сол бағаннан мән қайтарылады.
Кесте идентификаторын қайдан табуға болады?
Чат-бот функцияларымен жұмыс істеу үшін кесте идентификаторы қажет. Тізімнен қажетті кестені тауып, оны басыңыз.
Содан кейін мекенжай жолағын басыңыз.
Мекенжай жолағында сіз келесідей URL көресіз: https://salebot.pro/projects/11111/table/2, одан қажетті кестенің идентификаторын таба аласыз:
Кестеден жазбаны алу
get_records_from_table(table_id, start_row, count, start_col, end_col) - кестеден жазбаны алу.
| Параметр | Сипаттама | Ескерту |
|---|---|---|
| table_id | кесте идентификаторы | |
| start_row | Міндетті емес параметр, бүтін сан. Жолдар диапазонының басын көрсетеді. | Оқуды бастау үшін жол нөмірі (қоса алғанда). Тырнақшасыз жазыңыз. |
| count | Міндетті емес параметр, бүтін сан. Алынатын жолдар санын көрсетеді. | Әдепкі бойынша мән 1000, максимум 5000. Тырнақшасыз көрсетіңіз. |
| start_col | Міндетті емес параметр, жол. Бағандар диапазонының басын көрсетеді. | Оқуды бастау үшін бағанның атауы (қоса алғанда). Тырнақшада жазыңыз. |
| end_col | Міндетті емес параметр, жол. Бағандар диапазонының соңын көрсетеді. | Кесте мәндерін оқу үшін бағанның атауы (қоса алғанда). Тырнақшада жазыңыз. |
Егер сіз тек жол немесе баған диапазонының басын көрсетсеңіз, сол нүктеден бастап барлық деректер қайтарылады. Сондай-ақ, басын қалдырып, тек соңын көрсету арқылы сол нүктеге дейінгі деректерді алуға болады.
Мысал
Кестеден жазбаларды алу қажет блокта, блок параметрлеріндегі "Калькулятор" бөліміне өтіп, қажетті параметрлері бар функцияны енгізіңіз.
Деректердің кестеде қалай көрсетілетінін көрейік.
Енді "Бастау" блогын тест режимінде орындаңыз.
Бот жіберген хабарламада кестеден айнымалыға жазылған деректерді көре аламыз. Біз хабарламада #{} синтаксисі арқылы айнымалыға сілтеме жасағандықтан, онда сақталған деректер бот чатында көрсетілді.
Кестеден көрсетілген диапазондағы деректерді алу
table_read_cells(table_id, cell_data) - диапазондарды көрсету арқылы кестеден деректерді алуға мүмкіндік береді.
Егер сұраныс кезінде ешқандай мәселе болмаса, жауап күйі мен барлық ұяшықтарды олардың мәндерімен қамтитын сөздік болады:
{"status": true, "A1": "value", "A3": "value", "B3": "value", "A4": "value", "B4": "value", "C1": "", "C2": "value", "C3": "ddddddd"немесе қате жағдайында: {"status": false, "err": "Қате туралы хабарлама немесе сипаттама"}
Калькулятордағы мысал
Мысалы, кесте ұяшықтарында келесі көрсетілген мәндер бар:
Бот арқылы кестеден деректерді алу үшін Калькулятордағы функцияларға қажетті диапазондарды беріңіз.
Мысалда айнымалыны сақтайтын #{res} конструкциясы функция мен көрсетілген диапазонды пайдаланып алынған деректерді хабарламада көрсетуге көмектеседі:
Егер баған атаулары әртүрлі болса (мысалы, "Өнім", "Саны", "Сома"), диапазонды {"Product1":"Amount3"} форматында көрсету керек, мұнда:
• Product - бірінші бағанның атауы
• 1 - бұл 1-баған екенін көрсетеді
• Amount - үшінші бағанның атауы
• 3 - бұл 3-баған екенін көрсетеді
