Google Apps Script: Сортировка таблицы по столбцу

/**
 * Сортирует данные на активном листе по указанному столбцу.
 *
 * @param {number} columnIndex Номер столбца для сортировки (начиная с 1).
 * @param {boolean} ascending Порядок сортировки: true = по возрастанию, false = по убыванию.
 * @param {number} headerRows Количество строк заголовка (обычно 1), которые нужно исключить из сортировки.
 */
function sortSheetBySingleColumn(columnIndex: number, ascending: boolean, headerRows: number = 1): void {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();

  // Получаем весь диапазон данных на листе
  const fullDataRange = sheet.getDataRange();

  // Проверяем, достаточно ли строк для сортировки (данные + заголовок)
  if (fullDataRange.getNumRows() <= headerRows) {
    Logger.log('Недостаточно строк для сортировки.');
    return; 
  }

  // Вычисляем диапазон данных для сортировки (исключая заголовки)
  const sortRange = fullDataRange.offset(headerRows, 0, fullDataRange.getNumRows() - headerRows);

  // Выполняем сортировку
  try {
    sortRange.sort({
      column: columnIndex,
      ascending: ascending
    });
    Logger.log(`Лист '${sheet.getName()}' отсортирован по столбцу ${columnIndex} (${ascending ? 'по возрастанию' : 'по убыванию'}).`);
  } catch (e) {
    Logger.log(`Ошибка сортировки: ${e}`);
    // Можно добавить уведомление пользователя через Browser.msgBox или Toast
    // Browser.msgBox(`Ошибка сортировки: ${e}`); 
  }
}

// Пример вызова функции: сортировка по 3-му столбцу по убыванию
function runSortExample(): void {
  // Предполагаем, что в столбце C (индекс 3) находятся числовые данные для сортировки
  sortSheetBySingleColumn(3, false, 1); 
}

// Пример вызова sort() для нескольких столбцов
rangeToSort.sort([
  { column: 2, ascending: true },  // Сначала по столбцу B по возрастанию
  { column: 4, ascending: false } // Затем по столбцу D по убыванию
]);

/**
 * Сортирует данные на активном листе по нескольким столбцам.
 *
 * @param {Array