Google Apps Script: Экспорт данных из таблицы в CSV – Полное руководство

/**
 * Получает доступ к активной Google Таблице и конкретному листу.
 * @param {string} sheetName Имя листа для доступа.
 * @returns {GoogleAppsScript.Spreadsheet.Sheet | null} Объект листа или null, если лист не найден.
 */
function getSheet_(sheetName: string): GoogleAppsScript.Spreadsheet.Sheet | null {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(sheetName);
  if (!sheet) {
    Logger.log(`Лист с именем '${sheetName}' не найден.`);
  }
  return sheet;
}

/**
 * Преобразует двумерный массив данных в строку CSV.
 * @param {any[][]} data Двумерный массив данных.
 * @param {string} delimiter Разделитель полей (например, ',').
 * @returns {string} Строка в формате CSV.
 */
function convertToCsv_(data: any[][], delimiter: string): string {
  return data.map(row => {
    return row.map(cell => {
      let cellValue = cell === null || cell === undefined ? '' : String(cell);
      // Экранирование кавычек и оборачивание в кавычки, если значение содержит разделитель, кавычки или перенос строки
      if (cellValue.includes(delimiter) || cellValue.includes('"') || cellValue.includes('\n')) {
        cellValue = '"' + cellValue.replace(/"/g, '""') + '"';
      }
      return cellValue;
    }).join(delimiter);
  }).join('\n'); // Соединяем строки символом новой строки
}

/**
 * Сохраняет CSV строку в файл на Google Диске.
 * @param {string} csvContent Содержимое CSV файла.
 * @param {string} fileName Имя создаваемого файла (включая .csv).
 * @param {string} [encoding='UTF-8'] Кодировка файла.
 */
function saveCsvToDrive_(csvContent: string, fileName: string, encoding: string = 'UTF-8'): void {
  try {
    const blob = Utilities.newBlob(csvContent, MimeType.CSV, fileName).setBytes(Utilities.newBlob(csvContent).getBytes()).setName(fileName);
    // Установка кодировки (может быть не всегда необходимо явно, зависит от среды)
    // blob.setContentType('text/csv; charset=' + encoding);
    const file = DriveApp.createFile(blob);
    Logger.log(`Файл '${fileName}' успешно создан на Google Диске. URL: ${file.getUrl()}`);
  } catch (e: any) {
    Logger.log(`Ошибка при сохранении файла: ${e.message}. Stack: ${e.stack}`);
    throw new Error(`Не удалось сохранить файл: ${e.message}`);
  }
}

/**
 * Экспортирует все данные с указанного листа в CSV файл на Google Диск.
 */
function exportSheetToCsv(): void {
  const SHEET_NAME: string = 'Лист1'; // Укажите имя вашего листа
  const FILE_NAME: string = `export_${SHEET_NAME}_${new Date().toISOString().slice(0, 10)}.csv`;
  const DELIMITER: string = ',';

  const sheet = getSheet_(SHEET_NAME);
  if (!sheet) {
    Logger.log(`Экспорт прерван: лист '${SHEET_NAME}' не найден.`);
    return;
  }

  try {
    const data = sheet.getDataRange().getValues();
    if (data.length === 0) {
      Logger.log(`Лист '${SHEET_NAME}' пуст. Экспорт не выполнен.`);
      return;
    }

    const csvContent = convertToCsv_(data, DELIMITER);
    saveCsvToDrive_(csvContent, FILE_NAME);

  } catch (e: any) {
    Logger.log(`Ошибка при экспорте листа '${SHEET_NAME}': ${e.message}. Stack: ${e.stack}`);
    SpreadsheetApp.getUi().alert(`Ошибка экспорта: ${e.message}`);
  }
}

// --- Вспомогательные функции (должны быть добавлены в скрипт) ---

/**
 * Получает доступ к активной Google Таблице и конкретному листу.
 * @param {string} sheetName Имя листа для доступа.
 * @returns {GoogleAppsScript.Spreadsheet.Sheet | null} Объект листа или null, если лист не найден.
 */
function getSheet_(sheetName: string): GoogleAppsScript.Spreadsheet.Sheet | null {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(sheetName);
  if (!sheet) {
    Logger.log(`Лист с именем '${sheetName}' не найден.`);
    SpreadsheetApp.getUi().alert(`Лист '${sheetName}' не найден.`);
  }
  return sheet;
}

/**
 * Преобразует двумерный массив данных в строку CSV.
 * @param {any[][]} data Двумерный массив данных.
 * @param {string} delimiter Разделитель полей (например, ',').
 * @returns {string} Строка в формате CSV.
 */
function convertToCsv_(data: any[][], delimiter: string): string {
 return data.map(row => {
    return row.map(cell => {
      let cellValue = cell === null || cell === undefined ? '' : String(cell);
      if (cellValue.includes(delimiter) || cellValue.includes('"') || cellValue.includes('\n')) {
        cellValue = '"' + cellValue.replace(/"/g, '""') + '"';
      }
      return cellValue;
    }).join(delimiter);
  }).join('\n');
}

/**
 * Сохраняет CSV строку в файл на Google Диске.
 * @param {string} csvContent Содержимое CSV файла.
 * @param {string} fileName Имя создаваемого файла (включая .csv).
 * @param {string} [encoding='UTF-8'] Кодировка файла.
 */
function saveCsvToDrive_(csvContent: string, fileName: string, encoding: string = 'UTF-8'): void {
  try {
    const blob = Utilities.newBlob(csvContent, MimeType.CSV, fileName);
    // При необходимости указать кодировку явно, можно использовать setBytes:
    // const blob = Utilities.newBlob([], MimeType.CSV, fileName).setBytes(Utilities.newBlob(csvContent, undefined, encoding).getBytes());
    const file = DriveApp.createFile(blob);
    Logger.log(`Файл '${fileName}' успешно создан на Google Диске. URL: ${file.getUrl()}`);
    SpreadsheetApp.getUi().alert(`Файл '${fileName}' успешно создан.`);
  } catch (e: any) {
    Logger.log(`Ошибка при сохранении файла: ${e.message}. Stack: ${e.stack}`);
    throw new Error(`Не удалось сохранить файл: ${e.message}`);
  }
}

/**
 * Экспортирует данные с листа с настраиваемыми параметрами CSV.
 */
function exportSheetWithCustomSettings(): void {
  const SHEET_NAME: string = 'CampaignData'; // Лист с данными рекламных кампаний
  const FILE_NAME: string = `export_campaign_${new Date().toISOString().slice(0, 10)}.csv`;
  const DELIMITER: string = ';'; // Используем точку с запятой
  const ENCODING: string = 'UTF-8'; // Используем UTF-8

  const sheet = getSheet_(SHEET_NAME);
  if (!sheet) return;

  try {
    const data = sheet.getDataRange().getValues();
    if (data.length === 0) {
      Logger.log(`Лист '${SHEET_NAME}' пуст.`);
      return;
    }

    const csvContent = convertToCsv_(data, DELIMITER);
    saveCsvToDrive_(csvContent, FILE_NAME, ENCODING);

  } catch (e: any) {
    Logger.log(`Ошибка при экспорте листа '${SHEET_NAME}': ${e.message}`);
    SpreadsheetApp.getUi().alert(`Ошибка экспорта: ${e.message}`);
  }
}

// Требуются те же вспомогательные функции: getSheet_, convertToCsv_, saveCsvToDrive_

/**
 * Экспортирует данные из указанного диапазона в CSV файл.
 */
function exportRangeToCsv(): void {
  const SHEET_NAME: string = 'WebsiteAnalytics';
  const RANGE_A1_NOTATION: string = 'A1:D50'; // Экспортируем первые 50 строк, столбцы A-D
  const FILE_NAME: string = `export_analytics_range_${new Date().toISOString().slice(0, 10)}.csv`;
  const DELIMITER: string = ',';

  const sheet = getSheet_(SHEET_NAME);
  if (!sheet) return;

  try {
    const range = sheet.getRange(RANGE_A1_NOTATION);
    const data = range.getValues();

    if (data.length === 0 || (data.length === 1 && data[0].length === 0)) {
        Logger.log(`Диапазон '${RANGE_A1_NOTATION}' на листе '${SHEET_NAME}' пуст или не содержит данных.`);
        SpreadsheetApp.getUi().alert(`Диапазон '${RANGE_A1_NOTATION}' пуст.`);
        return;
    }

    const csvContent = convertToCsv_(data, DELIMITER);
    saveCsvToDrive_(csvContent, FILE_NAME);

  } catch (e: any) {
    Logger.log(`Ошибка при экспорте диапазона '${RANGE_A1_NOTATION}': ${e.message}`);
    SpreadsheetApp.getUi().alert(`Ошибка экспорта диапазона: ${e.message}`);
  }
}

// Требуются те же вспомогательные функции: getSheet_, convertToCsv_, saveCsvToDrive_