Как отсортировать диапазон в Google Sheets с помощью Apps Script?

/**
 * Получает активный лист и указанный диапазон.
 * @returns {GoogleAppsScript.Spreadsheet.Range | null} Объект диапазона или null, если лист не найден.
 */
function getTargetRange(): GoogleAppsScript.Spreadsheet.Range | null {
  const ss: GoogleAppsScript.Spreadsheet.Spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet: GoogleAppsScript.Spreadsheet.Sheet | null = ss.getSheetByName('Отчет по кампаниям'); // Замените на имя вашего листа
  if (!sheet) {
    Logger.log('Лист "Отчет по кампаниям" не найден.');
    return null;
  }
  // Пример: диапазон A2:E, исключая заголовок в строке 1
  const range: GoogleAppsScript.Spreadsheet.Range = sheet.getRange('A2:E' + sheet.getLastRow()); 
  return range;
}

/**
 * Сортирует диапазон A2:E на листе 'Отчет по кампаниям' по первому столбцу (A) по возрастанию.
 */
function simpleSortByFirstColumn(): void {
  const range: GoogleAppsScript.Spreadsheet.Range | null = getTargetRange();
  if (range) {
    range.sort(1); // Сортировка по первому столбцу (индекс 1)
    Logger.log('Диапазон отсортирован по столбцу A.');
  }
}

/**
 * Сортирует данные по рекламным кампаниям: сначала по CTR (столбец D) по убыванию,
 * затем по Названию кампании (столбец A) по возрастанию.
 */
function multiColumnSortExample(): void {
  const range: GoogleAppsScript.Spreadsheet.Range | null = getTargetRange(); 
  if (range) {
    // CTR - 4-й столбец в диапазоне A2:E
    // Название кампании - 1-й столбец в диапазоне A2:E
    range.sort([
      { column: 4, ascending: false }, // Сортировка по CTR (убывание)
      { column: 1, ascending: true }   // Затем по Названию (возрастание)
    ]);
    Logger.log('Диапазон отсортирован по CTR (убывание), затем по Названию (возрастание).');
  }
}

/**
 * Сортирует данные о кликах (столбец C) по убыванию.
 * @param {GoogleAppsScript.Spreadsheet.Range} rangeToSort Диапазон для сортировки.
 */
function sortByClicksDescending(rangeToSort: GoogleAppsScript.Spreadsheet.Range): void {
   // Столбец C - 3-й в диапазоне A2:E
  rangeToSort.sort({ column: 3, ascending: false });
  Logger.log('Диапазон отсортирован по кликам (убывание).');
}

/**
 * Сортирует данные по названию кампании (столбец A) по возрастанию.
 * @param {GoogleAppsScript.Spreadsheet.Range} rangeToSort Диапазон для сортировки.
 */
function sortByCampaignNameAscending(rangeToSort: GoogleAppsScript.Spreadsheet.Range): void {
  // Столбец A - 1-й в диапазоне A2:E
  rangeToSort.sort({ column: 1, ascending: true });
  Logger.log('Диапазон отсортирован по названию кампании (возрастание).');
}

// Пример использования:
function runSortExamples(): void {
  const range = getTargetRange();
  if(range) {
    // Сначала по убыванию кликов
    sortByClicksDescending(range);
    SpreadsheetApp.flush(); // Применить изменения перед следующей сортировкой
    Utilities.sleep(1000); // Небольшая пауза (опционально)

    // Затем по названию кампании
    // sortByCampaignNameAscending(range); // Раскомментируйте, если нужно применить обе
  }
}

/**
 * Сортирует диапазон по столбцу с датами (например, столбец B) по возрастанию.
 * @param {GoogleAppsScript.Spreadsheet.Range} rangeToSort Диапазон для сортировки.
 */
function sortByDateAscending(rangeToSort: GoogleAppsScript.Spreadsheet.Range): void {
  // Предполагаем, что даты находятся во 2-м столбце диапазона
  rangeToSort.sort({ column: 2, ascending: true });
  Logger.log('Диапазон отсортирован по дате (возрастание).');
}

/**
 * Сортирует диапазон по первому столбцу с учетом регистра.
 * ВНИМАНИЕ: Перезаписывает данные в диапазоне.
 */
function caseSensitiveSort(): void {
  const range: GoogleAppsScript.Spreadsheet.Range | null = getTargetRange();
  if (!range) return;

  // 1. Получаем данные из диапазона
  const data: any[][] = range.getValues();

  // 2. Сортируем массив данных с использованием стандартного Array.prototype.sort()
  //    Сравнение строк в JavaScript учитывает регистр.
  data.sort((a, b) => {
    const valueA: string = String(a[0]); // Сравниваем по первому столбцу (индекс 0)
    const valueB: string = String(b[0]);
    if (valueA  valueB) {
      return 1;
    }
    return 0;
  });

  // 3. Записываем отсортированные данные обратно в диапазон
  range.setValues(data);
  Logger.log('Диапазон отсортирован по первому столбцу с учетом регистра.');
}

/**
 * Простой триггер onEdit для автоматической сортировки данных
 * при редактировании любого значения в столбцах A-E листа 'Отчет по кампаниям'.
 * Сортирует по столбцу D (CTR) по убыванию.
 *
 * @param {GoogleAppsScript.Events.SheetsOnEdit} e Объект события редактирования.
 */
function onEditAutoSort(e: GoogleAppsScript.Events.SheetsOnEdit): void {
  const editedRange: GoogleAppsScript.Spreadsheet.Range = e.range;
  const sheet: GoogleAppsScript.Spreadsheet.Sheet = editedRange.getSheet();
  const sheetName: string = 'Отчет по кампаниям'; // Целевой лист
  const sortColumnIndex: number = 4; // Индекс столбца для сортировки (D)

  // Проверяем, что редактирование произошло на нужном листе и в нужных столбцах
  if (sheet.getName() === sheetName && editedRange.getColumn() >= 1 && editedRange.getColumn()  headerRows) {
      const dataRange: GoogleAppsScript.Spreadsheet.Range = sheet.getRange(headerRows + 1, 1, sheet.getLastRow() - headerRows, 5); // A2:E...
      dataRange.sort({ column: sortColumnIndex, ascending: false });
      // Logger.log('Автоматическая сортировка выполнена.'); // Можно раскомментировать для отладки
    }
  }
}

/**
 * Выполняется при открытии таблицы, добавляет пользовательское меню.
 */
function onOpen(): void {
  SpreadsheetApp.getUi()
    .createMenu('Сортировка')
    .addItem('Сортировать отчет по CTR (убывание)', 'sortReportByCTRDesc')
    .addItem('Сортировать отчет по Названию (возрастание)', 'sortReportByNameAsc')
    .addToUi();
}

/**
 * Функция, вызываемая из меню для сортировки по CTR.
 */
function sortReportByCTRDesc(): void {
  const range = getTargetRange();
  if(range) {
     // Столбец D - 4-й в диапазоне A2:E
     sortByClicksDescending(range); // Используем ранее созданную функцию
     SpreadsheetApp.getActiveSpreadsheet().toast('Отчет отсортирован по CTR (убывание).');
  }
}

/**
 * Функция, вызываемая из меню для сортировки по Названию.
 */
function sortReportByNameAsc(): void {
  const range = getTargetRange();
  if(range) {
    // Столбец A - 1-й в диапазоне A2:E
    sortByCampaignNameAscending(range); // Используем ранее созданную функцию
    SpreadsheetApp.getActiveSpreadsheet().toast('Отчет отсортирован по Названию (возрастание).');
  }
}