Как получить значение ячейки в Google Sheets с помощью Apps Script?

/**
 * Получает объект Range для указанной ячейки.
 *
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Объект листа.
 * @param {number} row Индекс строки (начиная с 1).
 * @param {number} column Индекс столбца (начиная с 1).
 * @return {GoogleAppsScript.Spreadsheet.Range} Объект диапазона для одной ячейки.
 * @customfunction
 */
function getSingleCellRange_(sheet, row, column) {
  return sheet.getRange(row, column);
}

/**
 * Получает и логирует значение из ячейки A1 активного листа.
 */
function logValueFromA1() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  const range = sheet.getRange('A1'); // Получаем диапазон A1
  const value = range.getValue();     // Извлекаем значение
  Logger.log(`Значение в ячейке A1: ${value}, Тип: ${typeof value}`);
}

/**
 * Получает значение из ячейки B2 (вторая строка, второй столбец).
 *
 * @return {string | number | Date | boolean} Значение из ячейки B2.
 */
function getValueFromB2() {
  const sheet = SpreadsheetApp.getActiveSheet();
  // Используем числовые координаты: строка 2, столбец 2
  const range = sheet.getRange(2, 2);
  const value = range.getValue();
  Logger.log(`Значение в ячейке B2: ${value}`);
  return value;
}

/**
 * Пример: Получение бюджета рекламной кампании из ячейки C3.
 */
function getCampaignBudget() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('CampaignData'); // Предполагаем, что есть лист 'CampaignData'
  if (!sheet) {
    Logger.log('Лист CampaignData не найден.');
    return;
  }
  const budgetCell = sheet.getRange('C3');
  const budget = budgetCell.getValue();
  if (typeof budget === 'number'){
    Logger.log(`Бюджет кампании: ${budget.toFixed(2)}`);
  } else {
    Logger.log(`Не удалось прочитать бюджет из C3. Получено: ${budget}`);
  }
}

/**
 * Получает объект Range для указанного диапазона.
 *
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Объект листа.
 * @param {string} a1Notation Диапазон в A1 нотации (напр., 'A1:B10').
 * @return {GoogleAppsScript.Spreadsheet.Range} Объект диапазона.
 * @customfunction
 */
function getMultiCellRange_(sheet, a1Notation) {
  return sheet.getRange(a1Notation);
}

/**
 * Пример итерации по значениям диапазона.
 *
 * @param {any[][]} data Двумерный массив данных, полученный из getValues().
 */
function processRangeData(data) {
  data.forEach((row, rowIndex) => {
    row.forEach((cellValue, colIndex) => {
      Logger.log(`Строка ${rowIndex + 1}, Столбец ${colIndex + 1}: ${cellValue}`);
    });
  });
}

/**
 * Получает и логирует все значения из диапазона A1:B3.
 */
function logValuesFromA1B3() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange('A1:B3');
  const values = range.getValues(); // values будет [[A1, B1], [A2, B2], [A3, B3]]
  Logger.log(JSON.stringify(values));
  processRangeData(values); // Используем предыдущую функцию для детального лога
}

/**
 * Пример: Получение списка ключевых слов и их CPC из столбцов A и B.
 */
function getKeywordsAndCpc() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('KeywordData');
  if (!sheet) {
    Logger.log('Лист KeywordData не найден.');
    return;
  }
  // Предполагаем, что данные начинаются со второй строки (первая - заголовок)
  // и идут до последней строки с данными в столбце A.
  const startRow = 2;
  const lastRow = sheet.getLastRow();
  if (lastRow  ({
    keyword: row[0], // Значение из первого столбца (A)
    cpc: typeof row[1] === 'number' ? row[1].toFixed(2) : 'N/A' // Значение из второго столбца (B)
  }));

  Logger.log(`Отчет по ключевым словам:
 ${JSON.stringify(keywordReport, null, 2)}`);
}

/**
 * Пример преобразования строкового значения из ячейки в число.
 */
function convertCellToNumber() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange('D1'); // Ячейка с числом в виде текста, например '123.45'
  const valueAsString = range.getValue();

  if (typeof valueAsString === 'string' && valueAsString.trim() !== '') {
    const valueAsNumber = parseFloat(valueAsString);
    if (!isNaN(valueAsNumber)) {
      Logger.log(`Успешное преобразование: ${valueAsNumber}`);
    } else {
      Logger.log(`Не удалось преобразовать '${valueAsString}' в число.`);
    }
  } else {
    Logger.log(`Значение в D1 не является строкой или пусто: ${valueAsString}`);
  }
}

/**
 * Обрабатывает массив данных, пропуская пустые строки и логируя ошибки.
 *
 * @param {any[][]} data Двумерный массив данных.
 */
function handleEmptyAndErrors(data) {
  const processedData = [];
  data.forEach((row, rowIndex) => {
    // Пропускаем полностью пустые строки
    if (row.every(cell => cell === '')) {
      Logger.log(`Строка ${rowIndex + 1} пуста, пропускаем.`);
      return;
    }

    const processedRow = row.map((cell, colIndex) => {
      if (typeof cell === 'string' && cell.startsWith('#')) {
        Logger.log(`Обнаружена ошибка в ячейке [${rowIndex + 1}, ${colIndex + 1}]: ${cell}`);
        return null; // Или другое значение по умолчанию
      }
      if (cell === '') {
        return null; // Обрабатываем пустые ячейки как null
      }
      return cell;
    });
    processedData.push(processedRow);
  });
  // Logger.log(JSON.stringify(processedData));
  return processedData;
}

/**
 * Получает данные из диапазона, используя кэш.
 *
 * @param {string} sheetName Имя листа.
 * @param {string} rangeA1Notation Диапазон в A1 нотации.
 * @param {number} expirationSeconds Время жизни кэша в секундах (макс 21600).
 * @return {any[][] | null} Данные из кэша или таблицы, или null при ошибке.
 */
function getValuesWithCache(sheetName, rangeA1Notation, expirationSeconds = 300) {
  const cache = CacheService.getScriptCache();
  const cacheKey = `sheetData_${sheetName}_${rangeA1Notation}`;

  const cached = cache.get(cacheKey);
  if (cached != null) {
    Logger.log('Данные получены из кэша.');
    return JSON.parse(cached);
  }

  Logger.log('Кэш пуст, получаем данные из таблицы.');
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(sheetName);
  if (!sheet) return null;

  const range = sheet.getRange(rangeA1Notation);
  const values = range.getValues();

  cache.put(cacheKey, JSON.stringify(values), expirationSeconds);
  return values;
}

/**
 * Получает все данные с листа, определяя диапазон динамически.
 *
 * @param {GoogleAppsScript.Spreadsheet.Sheet} sheet Объект листа.
 * @return {any[][]} Двумерный массив всех данных листа.
 */
function getAllSheetData(sheet) {
  const lastRow = sheet.getLastRow();
  const lastCol = sheet.getLastColumn();

  // Если лист пуст
  if (lastRow === 0 || lastCol === 0) {
      return [];
  }

  return sheet.getRange(1, 1, lastRow, lastCol).getValues();
}

/**
 * Пример: Получение данных о кампаниях с бюджетом > 1000.
 */
function getHighBudgetCampaigns() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('CampaignData');
  if (!sheet) return;

  const dataRange = sheet.getDataRange(); // Весь диапазон с данными
  const allData = dataRange.getValues();

  // Предполагаем структуру: [CampaignName, Status, Budget (столбец C, индекс 2), Clicks, ...]
  // Пропускаем заголовок (первую строку)
  const header = allData.shift();

  const filteredCampaigns = allData.filter(row => {
    const budget = row[2]; // Бюджет в третьем столбце
    return typeof budget === 'number' && budget > 1000;
  });

  Logger.log(`Кампании с бюджетом > 1000:
 ${JSON.stringify(filteredCampaigns, null, 2)}`);

  // Можно добавить заголовки обратно для удобства
  filteredCampaigns.unshift(header);
  // Дальнейшая обработка или запись отфильтрованных данных...
}