Бұл мүмкіндік максималды тарифте қолжетімді

  • 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 функциясы арқылы орындалады.

Тақырып толтырылуы керек (бірінші жолда кемінде бір ұяшық)

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 - Google кестеңіздің идентификаторы. Оны Google кестеңізге сілтемеден алуға болады (төмендегі сілтемеде қалың қаріппен белгіленген). https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0

a, b, c, d - жай ғана баған атаулары list_name - парағыңыздың атауы (мысалы, "File 2")

Егер сұранысты орындауда қиындық болмаса, жауап {"number_row":8} келеді. Сіз бұл жол нөмірін сақтап, кейінгі жұмыс үшін пайдалана аласыз.

Егер кестеңізге кіруді аккаунтыңызбен шектеу қаупін алғыңыз келмесе, деректер файлыңыздың URL-інен creds_path параметрін беруіңіз керек.

Бұл туралы толығырақ Жеке аккаунт арқылы жұмыс істеу бөлімінде:

{"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": "File name"}}

Егер сұраныста қиындық болмаса, ешқандай параметр қайтарылмайды.

Егер кестеңізге кіруді аккаунтыңызбен шектеу қаупін алғыңыз келмесе, деректер файлыңыздың URL-інен creds_path параметрін беруіңіз керек.

Бұл туралы толығырақ Жеке аккаунт арқылы жұмыс істеу бөлімінде:

{"id": "id table", "write":{"a1"::"#{variable}", "b3": "#{yet}", "c1": "#{more}", "d20"just text}, "cred_name"Sheet name", s_"path": Path to your data file with authorization}

!!!

Белгілі ұяшықтардан жазбаларды қалай жою керек

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": "File name"}

Егер сұраныста қиындық болмаса, ешқандай параметр қайтарылмайды.

Егер кестеңізге кіруді аккаунтыңызбен шектеу қаупін алғыңыз келмесе, деректер файлыңыздың URL-інен creds_path параметрін беруіңіз керек. Бұл туралы толығырақ Жеке аккаунт арқылы жұмыс істеу бөлімінде:

{"id": "table id", "remove":[a1", "b3", "c2"], "list_name": "File name","creds_path": "The path to your data file for authorization"}

Жолдағы бірінші бос ұяшыққа қалай жазу керек

Деректерді көрсетілген жолға жазуға болады, жазба соңғы толтырылған ұяшықтың оң жағындағы бос ұяшыққа жасалады. Бұл 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": "Name of the sheet"} Мұндағы id - Google кестеңіздің идентификаторы. Оны Google кестеңізге сілтемеден алуға болады (төмендегі сілтемеде қалың қаріппен белгіленген). https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0

append_in_row - жазу үшін жол нөмірі

value - ұяшыққа жазылатын мән

Егер сұранысты орындауда қиындық болмаса, жауап {"number_col":10,"col_name":"J3"} келеді. Сіз бұл нөмірлерді сақтап, кейінгі жұмыс үшін пайдалана аласыз.

Егер кестеңізге кіруді аккаунтыңызбен шектеу қаупін алғыңыз келмесе, деректер файлыңыздың URL-інен creds_path параметрін беруіңіз керек. Қосымша ақпаратты Жеке аккаунт арқылы жұмыс істеу бөлімінен қараңыз: {"id": "id table", "mapping":"{"a":"#{variable}", "b": "#{more}", "c": "#{more}, "cred"simply text"},"s_": path to your data with"path}"

Кестеден деректерді қалай оқу керек

URL функциялары: https://store.salebot.pro/function/gsheets

{"id": "id table", "read":{"a1":"a1", "b3": "b4", "c1": "c10", "d20":"a1"}} Ауқымдарды беру үшін параметрлерді орнатыңыз. Мысалда "a1":"a1" бір ұяшықты қайтарады, ал "c1":"c10" c бағанынан 10 мәнді қайтарады. Қайтарылған хэш ұяшық мекенжайы мен оның мәндерінен тұрады.

Бағандарды нөмірлеу бірден басталады.

Егер мәндерді бірінші парақтан емес оқығыңыз келсе, сұранысқа 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"} Егер кестеңізге кіруді аккаунтыңызбен шектеу қаупін алғыңыз келмесе, деректер файлыңыздың URL-інен creds_path параметрін беруіңіз керек. Бұл туралы толығырақ Жеке аккаунт арқылы жұмыс істеу бөлімінде:

{"id": "id table", "read"::{"a1":"a3", "b3": "b6"}, "list_name": "Sheet name","creds_path": "path path path to your data file for authorization"}