Заполнение через API
Заполняйте таблицу из внешней интеграции и обновляйте её структуру через API.
Сначала создайте таблицу в нужном проекте.
Подготовьте доступ
Внешняя интеграция может заполнить даже пустую таблицу без предварительной загрузки CSV или XLSX. Используйте проектный API-ключ или OAuth-токен с правом can_manage_knowledge_base; точные тела запросов и модели ответов доступны в разделе API базы знаний, а подключение клиента описано в статье «API SDK».
Проектный ключ или токен приложения должен относиться к тому же проекту, что и таблица. При работе по OAuth от имени пользователя нужны и разрешение токена, и доступ самого пользователя к управлению базой знаний.
Запись данных
Для разных задач предусмотрены отдельные операции:
POST /api/knowledge-base/tables/:id/rowsдобавляет прямоугольный блок после последней используемой строки;PATCH /api/knowledge-base/tables/:id/cellsменяет отдельные ячейки;PUT /api/knowledge-base/tables/:id/rangeзаписывает прямоугольный блок, начиная с указанной ячейки.
При добавлении строк и записи диапазона задайте размер блока в row_count и column_count. Значения передаются отдельно в text_cells, number_cells и boolean_cells, а row_index и column_index считаются с нуля внутри этого блока. Неуказанные позиции записываются пустыми, в том числе поверх существующих данных при записи диапазона.
Для изменения отдельных ячеек укажите адреса, например A2 или B3. Помимо текста, чисел и логических значений эта операция принимает formula_cells для формул и empty_cells для очистки. Она затрагивает только перечисленные позиции. Один адрес нельзя указывать несколько раз, даже в разных списках типов.
Один запрос обрабатывает не больше 10 000 ячеек; прямоугольный блок также ограничен 5 000 строками. sheet_id выбирает лист, без него используется первый. Сначала можно передать dry_run: true, чтобы проверить запрос без изменения таблицы; для записи отправьте запрос без этого флага или со значением false.
Запись диапазона работает с физическим адресом таблицы; она не ищет строку по артикулу, email или другому бизнес-ключу и не заменяет upsert.
Успешный ответ означает, что изменение принято таблицей. Снимок workbook_snapshot, который используется для чтения и поиска, обновляется асинхронно и сразу после записи может ещё содержать предыдущие данные. Если интеграции нужно прочитать именно новый результат, ограниченное время повторно запрашивайте таблицу, пока не увеличится version или sheet_revision; не запускайте бесконечный опрос.