Google Tables

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

Мазмұны

• Google Sheets кестесін қалай дайындау керек
• JSON сұранысын қалай жазу керек
• Белгілі бағандарға жолдарды қалай жазу керек
• Белгілі ұяшықтарға деректерді қалай жазу керек
• Белгілі ұяшықтардан деректерді қалай жою керек
• Жолдағы бірінші бос ұяшыққа қалай жазу керек
• Кестеден деректерді қалай оқу керек
• Кестеден мәтінді қалай табу керек (бірінші сәйкес жолды қайтару)
• Кестедегі барлық сәйкестіктерді қалай тізімдеу керек
• Жолды толығымен қалай жою керек (ығысумен)
• Бағанды толығымен қалай жою керек (ығысумен)
• Кестедегі парақты таңдау үшін түймелерді қалай жасау керек
• Аккаунт арқылы қалай жұмыс істеу керек
• Баған әріптерімен қалай жұмыс істеу керек
• Баған атауларында айнымалыларды қалай орнату керек
• Кестеден деректерді қалай жою керек
• Кестеге парақты қалай қосу керек
• Ықтимал қателер
• Google Sheets функциялары (API)

Бұл мақалада боттардың Google Sheets кестелерімен қалай әрекеттесетінін қарастырамыз.

Бұл функционалды пайдалану үшін сізге қажет:

• Сілтеме арқылы өңдеу құқығы қосылған Google Sheets кестесі
• Функцияның URL мекенжайы
• Сұраныс параметрлері

JSON сұранысын қалай жазу керек

Сұраныс жібергіңіз келетін блоктың параметрлеріне өтіңіз.

POST JSON сұраныс түрін таңдап, қажетті функцияның URL мекенжайын енгізіп, JSON POST параметрлері өрісіне параметрлерді қосыңыз.

Сұранысыңыз қайтарған жауапты көру үшін Жауап өрісіне {custom_answer} енгізіп, блокты сақтап, тізбек бойымен өтіңіз.

Содан кейін жауаптағы жеке мәндерді JSON жауабынан мәндерді сақтау өрісінде келесі синтаксиспен айнымалыларға сақтауға болады:

parameters_from_query -> your_variable

Егер жауапта ішкі параметрлер болса, оларды келесідей шығарыңыз.

Мысалы, егер жауап келесідей болса:

{
  "cell_number": {
    "row": 4,
    "col": 2
  }
}

Мынаны қолданыңыз:

cell_number|row -> Row
cell_number|col -> Column

Енді боттардың Google Sheets кестелерімен не істей алатынын толығырақ қарастырайық.

Белгілі бағандарға жолдарды қалай жазу керек

Пайдаланушыдан деректерді жинап, оны кестедегі бірінші қолжетімді жолға жазуға болады. Бұл mapping функциясы арқылы орындалады.

Тақырып толтырылуы керек — бірінші жолдағы кемінде бір ұяшықта мән болуы керек.

Функцияның URL мекенжайы:

https://store.mavibot.ai/function/gsheets

Сұраныс параметрлері:

{
  "id": "table id",
  "mapping": {
    "a": "#{variable}",
    "b": "#{yet}",
    "c": "#{yet}",
    "d": "just text"
  }
}

Деректерді біріншіден басқа параққа жазғыңыз келсе, list_name параметрін қосыңыз:

{
  "id": "table id",
  "mapping": {
    "a": "just text",
    "b": "#{variable}"
  },
  "list_name": "Sheet name"
}

Мұндағы:

• id — Google Sheets кестеңіздің идентификаторы. Оны Google Sheets URL мекенжайынан алуға болады.
• a, b, c, d — баған атаулары.
• list_name — парақтың атауы, мысалы "Sheet 2".

Google Sheets URL мекенжайының мысалы:

https://docs.google.com/spreadsheets/d/1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4/edit#gid=0

Бұл мысалда кесте идентификаторы:

1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4

Сұраныс сәтті аяқталса, жауап келесідей болады:

{
  "number_row": 8
}

Қайтарылған жол нөмірін сақтап, кейінірек пайдалануға болады.

Кестені сілтеме арқылы жалпыға өңдеуге ашық қылғыңыз келмесе, авторизация деректеріңіз бар файлға жолды көрсететін creds_path параметрін беруіңіз керек.

Қосымша ақпаратты Аккаунт арқылы жұмыс істеу бөлімінен қараңыз.

Мысал:

{
  "id": "table id",
  "mapping": {
    "a": "#{variable}",
    "b": "#{yet}",
    "c": "#{yet}",
    "d": "just text"
  },
  "creds_path": "path to your authorization data file"
}

Белгілі ұяшықтарға деректерді қалай жазу керек

Функцияның URL мекенжайы:

https://store.mavibot.ai/function/gsheets

Сұраныс параметрлері:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{yet}",
    "d20": "just text"
  }
}

Деректер сіз көрсеткен нақты ұяшықтарға жазылады — бұл мысалда: A1, B3, C1 және D20.

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

Деректерді біріншіден басқа параққа жазғыңыз келсе, list_name параметрін қосыңыз:

{
  "id": "table id",
  "write": {
    "a1": "#{variable}",
    "b3": "#{yet}",
    "c1": "#{yet}",
    "d20": "just text"
  },
  "list_name": "Sheet name"
}

Сұраныс сәтті аяқталса, ешқандай параметр қайтарылмайды.

Кестені сілтеме арқылы жалпыға өңдеуге ашық қылғыңыз келмесе, авторизация деректеріңіз бар файлға жолды көрсететін creds_path параметрін беріңіз.

Қосымша ақпаратты Аккаунт арқылы жұмыс істеу бөлімінен қараңыз.

Мысал:

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

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

Функцияның URL мекенжайы:

https://store.mavibot.ai/function/gsheets

Сұраныс параметрлері:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ]
}

Бұл көрсетілген ұяшықтардағы мәндерді жояды — бұл мысалда: A1, B3 және C2.

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

Біріншіден басқа парақтағы ұяшықтардан мәндерді жойғыңыз келсе, list_name параметрін қосыңыз:

{
  "id": "table id",
  "remove": [
    "a1",
    "b3",
    "c2"
  ],
  "list_name": "Sheet name"
}

Сұраныс сәтті аяқталса, ешқандай параметр қайтарылмайды.

Кестені сілтеме арқылы жалпыға өңдеуге ашық қылғыңыз келмесе, авторизация деректеріңіз бар файлға жолды көрсететін creds_path параметрін беріңіз.

Қосымша ақпаратты Аккаунт арқылы жұмыс істеу бөлімінен қараңыз.

Мысал:

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

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

Белгілі бір жолға деректер жазуға болады. Мән соңғы толтырылған ұяшықтың оң жағындағы бірінші бос ұяшыққа қосылады.

Бұл append_in_row функциясы арқылы орындалады.

Функцияның URL мекенжайы:

https://store.mavibot.ai/function/gsheets

Сұраныс параметрлері:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value"
}

Біріншіден басқа парақтағы жолға деректер жазғыңыз келсе, list_name параметрін қосыңыз:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value",
  "list_name": "Sheet name"
}

Мұндағы:

• id — Google Sheets кестеңіздің идентификаторы.
• append_in_row — мән жазылуы тиіс жол нөмірі.
• value — ұяшыққа жазылатын мән.
• list_name — парақтың атауы.

Сұраныс сәтті аяқталса, жауап келесідей болады:

{
  "number_col": 10,
  "col_name": "J3"
}

Қайтарылған мәндерді сақтап, кейінірек пайдалануға болады.

Кестені сілтеме арқылы жалпыға өңдеуге ашық қылғыңыз келмесе, авторизация деректеріңіз бар файлға жолды көрсететін creds_path параметрін беріңіз.

Мысал:

{
  "id": "table id",
  "append_in_row": "8",
  "value": "written value",
  "creds_path": "path to your authorization data file"
}

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

Функцияның URL мекенжайы:

https://store.mavibot.ai/function/gsheets

Сұраныс параметрлері:

{
  "id": "table id",
  "read": {
    "a1": "a1",
    "b3": "b4",
    "c1": "c10",
    "d20": "a1"
  }
}

Алу қажет ауқымдарды көрсету үшін read параметрін пайдаланыңыз.

Мысалы:

• "a1": "a1" бір ұяшықты қайтарады.
• "c1": "c10" C бағанынан 10 мәнді қайтарады.

Жауапта ұяшық мекенжайлары мен олардың мәндері болады.

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

Біріншіден басқа парақтан мәндерді оқығыңыз келсе, list_name параметрін қосыңыз:

{
  "id": "table id",
  "read": {
    "a1": "a3",
    "b3": "b6"
  },
  "list_name": "Sheet name"
}

Сұраныс сәтті аяқталса, жауапта ұяшық атаулары мен олардың мәндері болады.

Мысал:

{
  "A1": "value 1",
  "A2": "value 2",
  "A3": "value 3"
}

Кестені сілтеме арқылы жалпыға өңдеуге ашық қылғыңыз келмесе, авторизация деректеріңіз бар файлға жолды көрсететін creds_path параметрін беріңіз.

Қосымша ақпаратты Аккаунт арқылы жұмыс істеу бөлімінен қараңыз.

Мысал:

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