После вставки столбца найдите первое место, где скрипт выбирает поле по числу: row[3], getRange(..., 4) или фиксированный A1-диапазон. Эти адреса описывают позицию, поэтому новое поле сдвигает смысл. Для изменяемой таблицы стройте карту полей по проверенной строке заголовков и запрещайте запись при неоднозначности.

Индекс массива и координата листа отличаются

Google документирует getValues как двумерный массив с индексами от нуля, тогда как координаты Range начинаются с единицы. Источник проверен 27 октября 2026 года. После нахождения поля в массиве нельзя без преобразования использовать тот же индекс как номер столбца листа.

Условный пример для уже прочитанных headers и row:
const matches = headers.flatMap((h, i) => h === 'record_id' ? [i] : []);
if (matches.length !== 1) throw new Error('Schema mismatch');
const index = matches[0];
const recordId = row[index];
const sheetColumn = index + 1;

Пример предполагает начало диапазона в столбце A.
Для другого начала нужен его фактический столбец.

Этот фрагмент только показывает выбор поля, а не готовую обработку заказов. Строку заголовков, нужный лист и начальный столбец задавайте явно. Если скрипт запускается по триггеру, не полагайтесь на случайно выбранную пользователем активную вкладку.

Изменение схемыОжидаемая реакция
Добавлено необязательное полеРазрешить, если контракт допускает
Обязательное поле исчезлоОстановить запись с объяснением
Два одинаковых заголовкаОтказаться от неоднозначного выбора
Столбцы переставленыСохранить смысл по карте
Название поля изменилосьПрименить утверждённое соответствие или отказ

Человеческая подпись не всегда хороший идентификатор

Решите, допускается ли редактирование заголовков. Для контролируемой автоматизации удобны стабильные ключи полей или отдельная схема, а человекочитаемые подписи могут меняться независимо. Если используется только видимая строка, закрепите её контракт и понятное сообщение об ошибке.

Нормализацию заголовков выбирайте осторожно. Удаление пробелов по краям иногда полезно, но превращение похожих названий в одно может создать коллизию. После любой нормализации снова проверяйте уникальность. Не выбирайте первый совпавший столбец автоматически.

Проверяйте все обязательные поля до любых изменений. Если скрипт сначала запишет половину результатов, а затем обнаружит отсутствующий столбец, книга останется в частично обновлённом состоянии. Разделите чтение и проверку схемы, вычисление результата и контролируемую запись.

getDataRange возвращает область с данными, но не знает бизнес-смысл строк и столбцов. Документация Google проверена 27 октября 2026 года. Пустая строка заголовков, служебные блоки и данные сбоку требуют явного выбора рабочего диапазона, а не предположения, что вся область — одна таблица.

Перестановка становится регрессионным сценарием

  1. Сделать копию с синтетическими данными и отключёнными внешними действиями.
  2. Сохранить исходный результат для нескольких record_id.
  3. Вставить и переставить допустимые столбцы.
  4. Проверить одинаковый смысл результата по ключам записей.
  5. Удалить обязательное поле и убедиться, что запись не началась.

Добавьте тест с дублирующимся заголовком. Он выявляет опасный вариант, когда скрипт продолжает работать, но использует чужое поле. В отчёте об отказе достаточно имени схемы и проблемных заголовков; полные строки клиентов в журнале не нужны.

Если другие редакторы могут менять структуру во время запуска, согласуйте окно изменения или проверку версии схемы перед записью. Карта, прочитанная в начале, может устареть. Повтор запуска должен опираться на ключ записи и не создавать дубли из-за частично обработанного прошлого набора.

Для разбора приложите строку заголовков до и после, начальную координату диапазона и пример ожидаемого соответствия. Правильный результат — сохранение смысла полей при разрешённых перестановках и явный отказ до записи при нарушении схемы.

Проверенные источники