Ця функція доступна на максимальному тарифі.

Зміст

  • Як підготувати Google Таблицю
  • Як написати JSON-запит
  • Як записати рядки в певні стовпці
  • Як записати дані в певні комірки
  • Як видалити дані з певних комірок
  • Як записати в першу порожню комірку в рядку
  • Як прочитати дані з таблиці
  • Як знайти текст у таблиці (повернути перший відповідний рядок)
  • Як перелічити всі збіги в таблиці
  • Як повністю видалити рядок (зі зміщенням)
  • Як повністю видалити стовпець (зі зміщенням)
  • Як створити кнопки для вибору аркуша в таблиці
  • Як працювати через свій обліковий запис
  • Як працювати з літерами стовпців
  • Як встановити змінні в назвах стовпців
  • Як видалити дані з таблиці
  • Як додати аркуш до таблиці
  • Можливі помилки
  • Функції Google Таблиць (API)

У цій статті ми розглянемо, як боти можуть взаємодіяти з Google Таблицями.

Щоб використовувати цю функціональність, вам потрібно:

  • Google Таблиця з доступом до редагування через посилання
  • 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 Таблицями.

Як записати рядки в певні стовпці

Ви можете зібрати дані від користувача та записати їх у перший доступний рядок у таблиці. Це робиться за допомогою функції 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 Таблиці. Ви можете отримати його з URL-адреси Google Таблиці.
  • a, b, c, d — назви стовпців.
  • list_name — назва аркуша, наприклад "Sheet 2".

Приклад URL-адреси Google Таблиці:

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 Таблиці.
  • 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" повертає 10 значень зі стовпця C.

Відповідь містить адреси комірок та їх значення.

Нумерація стовпців починається з 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"
}