В данной статье мы разберем каким образом можно добавить в Google-таблицу одну или несколько строк, используя API-запрос.
Порядок действий
ВАЖНО
Для использования API таблица должна быть либо открыта для "всех, у кого есть ссылка", либо если нет такой возможности, то для пользователя twin-gsheets@gspread-restapi.iam.gserviceaccount.com
1. Перед отправкой запроса в сценарии необходимо с помощью блока результата объявить следующие переменные:
| Название | Значение |
|---|---|
| url | Ссылка на редактирование Google-таблицы. Получить ее можно нажав кнопку Настройки доступа на странице с таблицей, и открыв доступ для редактирования. |
| sheet | Название страницы таблицы в которую нужно добавить строку, например Лист1. |
Тип действия в блоке – Без действия
2. Затем нужно добавить блок Запрос к серверу, и задать следующие параметры:
| Параметр | Значение |
|---|---|
| Тип запроса | POST |
| URL | http://intgr.twin24.io:60061/add_rows?spreadsheet_url={url}&worksheet_name={sheet}, если значения ячеек нужно передать в исходном виде |
3. Далее нужно в этом же блоке задать тело запроса. В нем и будут находиться данные для передачи в таблицу.
В названии поля указывается следующее: data.X.Y, где X – номер новой строки, начиная с нуля, Y – номер столбца, начиная с нуля.
Нумерация строк относится только к новым строкам, и всегда должна начинаться с нуля.
В качестве значения поля может использоваться любая текстовая информация, переменные из сценария, и формулы для таблицы, если в URL запроса указан mode=1.
Пример заполнения тела запроса:
С таким телом запроса будет происходить отправка трех значений в одну строку, и одного в следующую, в таблице это будет выглядеть так:
При повторной отправке запроса снова будут добавлены две новые строки:
