Šī funkcija ir pieejama maksimālajā tarifā.

Saturs

  • Kā sagatavot Google izklājlapu
  • Kā uzrakstīt JSON vaicājumu
  • Kā ierakstīt rindas noteiktās kolonnās
  • Kā ierakstīt datus noteiktās šūnās
  • Kā dzēst datus no noteiktām šūnām
  • Kā ierakstīt pirmajā tukšajā šūnā rindā
  • Kā nolasīt datus no tabulas
  • Kā atrast tekstu tabulā (atgriezt pirmo atbilstošo rindu)
  • Kā uzskaitīt visus atbilstošos rezultātus tabulā
  • Kā pilnībā dzēst rindu (ar nobīdi)
  • Kā pilnībā dzēst kolonnu (ar nobīdi)
  • Kā izveidot pogas, lai atlasītu lapu tabulā
  • Kā strādāt caur savu kontu
  • Kā strādāt ar kolonnu burtiem
  • Kā iestatīt mainīgos kolonnu nosaukumos
  • Kā dzēst datus no tabulas
  • Kā pievienot lapu tabulai
  • Iespējamās kļūdas
  • Google izklājlapu funkcijas (API)

Šajā rakstā mēs apskatīsim, kā boti var mijiedarboties ar Google izklājlapām.

Lai izmantotu šo funkcionalitāti, jums ir nepieciešams:

  • Google izklājlapa ar rediģēšanas piekļuvi, kas iespējota, izmantojot saiti
  • Funkcijas URL
  • Vaicājuma parametri

Kā uzrakstīt JSON vaicājumu

Dodieties uz bloka iestatījumiem, no kura vēlaties nosūtīt pieprasījumu.

Izvēlieties POST JSON pieprasījuma veidu, ievadiet vajadzīgās funkcijas URL un pievienojiet parametrus laukā JSON POST parametri.

Lai redzētu atbildi, ko atgriež jūsu pieprasījums, ievadiet {custom_answer} laukā Atbilde, saglabājiet bloku un palaidiet ķēdi.

Pēc tam varat saglabāt atsevišķas vērtības no atbildes mainīgajos laukā Saglabāt vērtību no JSON atbildes, izmantojot šādu sintaksi:

parameters_from_query -> your_variable

Ja atbilde satur ligzdotus parametrus, izvelciet tos šādi.

Piemēram, ja atbilde ir:

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

Izmantojiet:

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

Tagad aplūkosim sīkāk, ko boti var darīt ar Google izklājlapām.

Kā ierakstīt rindas noteiktās kolonnās

Jūs varat apkopot datus no lietotāja un ierakstīt tos pirmajā pieejamajā rindā tabulā. Tas tiek darīts, izmantojot mapping funkciju.

Galvene ir jāaizpilda — vismaz vienai šūnai pirmajā rindā jābūt vērtībai.

Funkcijas URL:

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

Vaicājuma parametri:

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

Ja vēlaties ierakstīt datus citā lapā, nevis pirmajā, pievienojiet parametru list_name:

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

Kur:

  • id — jūsu Google izklājlapas ID. To var iegūt no Google izklājlapu URL.
  • a, b, c, d — kolonnu nosaukumi.
  • list_name — lapas nosaukums, piemēram, "Sheet 2".

Piemērs Google izklājlapu URL:

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

Šajā piemērā tabulas ID ir:

1aUbbUaw2SRnJFAavv06Noa1EzumhyShKDm7ie6lYKc4

Ja pieprasījums tiek veiksmīgi pabeigts, atbilde izskatīsies šādi:

{
  "number_row": 8
}

Jūs varat saglabāt atgriezto rindas numuru un izmantot to vēlāk.

Ja nevēlaties padarīt tabulu publiski rediģējamu, izmantojot saiti, jums jānorāda parametrs creds_path ar ceļu uz jūsu autorizācijas datu failu.

Plašāku informāciju skatiet sadaļā Strādāt caur savu kontu.

Piemērs:

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

Kā ierakstīt datus noteiktās šūnās

Funkcijas URL:

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

Vaicājuma parametri:

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

Dati tiek ierakstīti norādītajās šūnās — šajā piemērā: A1, B3, C1 un D20.

Kolonnu numerācija sākas no 1.

Ja vēlaties ierakstīt datus citā lapā, nevis pirmajā, pievienojiet parametru list_name:

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

Ja pieprasījums tiek veiksmīgi pabeigts, netiek atgriezti nekādi parametri.

Ja nevēlaties padarīt tabulu publiski rediģējamu, izmantojot saiti, norādiet parametru creds_path ar ceļu uz jūsu autorizācijas datu failu.

Plašāku informāciju skatiet sadaļā Strādāt caur savu kontu.

Piemērs:

{
  "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"
}

Kā dzēst datus no noteiktām šūnām

Funkcijas URL:

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

Vaicājuma parametri:

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

Tas noņem vērtības no norādītajām šūnām — šajā piemērā: A1, B3 un C2.

Kolonnu numerācija sākas no 1.

Ja vēlaties noņemt vērtības no šūnām citā lapā, nevis pirmajā, pievienojiet parametru list_name:

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

Ja pieprasījums tiek veiksmīgi pabeigts, netiek atgriezti nekādi parametri.

Ja nevēlaties padarīt tabulu publiski rediģējamu, izmantojot saiti, norādiet parametru creds_path ar ceļu uz jūsu autorizācijas datu failu.

Plašāku informāciju skatiet sadaļā Strādāt caur savu kontu.

Piemērs:

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

Kā ierakstīt pirmajā tukšajā šūnā rindā

Jūs varat ierakstīt datus norādītajā rindā. Vērtība tiks pievienota pirmajā tukšajā šūnā pa labi no pēdējās aizpildītās šūnas.

Tas tiek darīts, izmantojot append_in_row funkciju.

Funkcijas URL:

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

Vaicājuma parametri:

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

Ja vēlaties ierakstīt datus rindā citā lapā, nevis pirmajā, pievienojiet parametru list_name:

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

Kur:

  • id — jūsu Google izklājlapas ID.
  • append_in_row — rindas numurs, kurā jāieraksta vērtība.
  • value — vērtība, kas tiks ierakstīta šūnā.
  • list_name — lapas nosaukums.

Ja pieprasījums tiek veiksmīgi pabeigts, atbilde izskatīsies šādi:

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

Jūs varat saglabāt atgrieztās vērtības un izmantot tās vēlāk.

Ja nevēlaties padarīt tabulu publiski rediģējamu, izmantojot saiti, norādiet parametru creds_path ar ceļu uz jūsu autorizācijas datu failu.

Piemērs:

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

Kā nolasīt datus no tabulas

Funkcijas URL:

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

Vaicājuma parametri:

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

Izmantojiet parametru read, lai norādītu diapazonus, kurus vēlaties iegūt.

Piemēram:

  • "a1": "a1" atgriež vienu šūnu.
  • "c1": "c10" atgriež 10 vērtības no C kolonnas.

Atbilde satur šūnu adreses un to vērtības.

Kolonnu numerācija sākas no 1.

Ja vēlaties nolasīt vērtības no citas lapas, nevis pirmās, pievienojiet parametru list_name:

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

Ja pieprasījums tiek veiksmīgi pabeigts, atbilde saturēs šūnu nosaukumus un to vērtības.

Piemērs:

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

Ja nevēlaties padarīt tabulu publiski rediģējamu, izmantojot saiti, norādiet parametru creds_path ar ceļu uz jūsu autorizācijas datu failu.

Plašāku informāciju skatiet sadaļā Strādāt caur savu kontu.

Piemērs:

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