Google Apps Script: Как получить цвет ячейки?

/**
 * Получает цвет ячейки в формате HEX.
 *
 * @param {string} sheetName Имя листа.
 * @param {number} row Номер строки.
 * @param {number} column Номер столбца.
 * @return {string} Шестнадцатеричный код цвета ячейки.
 */
function getCellBackgroundColorHex(sheetName, row, column) {
  // Получаем доступ к Google Sheet.
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  // Получаем лист по имени.
  const sheet = ss.getSheetByName(sheetName);
  // Проверяем, что лист существует.
  if (!sheet) {
    Logger.log("Лист с именем '" + sheetName + "' не найден.");
    return null;
  }

  // Получаем ячейку по номеру строки и столбца.
  const cell = sheet.getRange(row, column);

  // Проверяем, что ячейка существует.
  if (!cell) {
    Logger.log("Ячейка с координатами (" + row + ", " + column + ") не найдена.");
    return null;
  }
  
  // Получаем цвет фона ячейки.
  const backgroundColor = cell.getBackground();
  
  return backgroundColor;
}

// Пример использования
function exampleUsage() {
  const color = getCellBackgroundColorHex("Лист1", 1, 1); // Получаем цвет ячейки A1 на листе "Лист1"
  Logger.log(color);
}

/**
 * Получает цвета фона нескольких ячеек в формате HEX.
 *
 * @param {string} sheetName Имя листа.
 * @param {number} startRow Начальный номер строки.
 * @param {number} startColumn Начальный номер столбца.
 * @param {number} numRows Количество строк.
 * @param {number} numColumns Количество столбцов.
 * @return {string[][]} Двумерный массив шестнадцатеричных кодов цветов.
 */
function getRangeBackgroundColorsHex(sheetName, startRow, startColumn, numRows, numColumns) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(sheetName);

  if (!sheet) {
    Logger.log("Лист с именем '" + sheetName + "' не найден.");
    return null;
  }

  const range = sheet.getRange(startRow, startColumn, numRows, numColumns);

  if (!range) {
    Logger.log("Диапазон с указанными параметрами не найден.");
    return null;
  }

  const backgroundColors = range.getBackgrounds();
  return backgroundColors;
}

// Пример использования
function exampleRangeUsage() {
  const colors = getRangeBackgroundColorsHex("Лист1", 1, 1, 3, 3); // Получаем цвета диапазона A1:C3
  Logger.log(colors);
}

/**
 * Преобразует HEX цвет в RGBA.
 *
 * @param {string} hex HEX цвет (например, "#ffffff").
 * @param {number} alpha Прозрачность (от 0 до 1).
 * @return {string} RGBA цвет (например, "rgba(255, 255, 255, 0.5)").
 */
function hexToRgba(hex, alpha) {
  if (!hex) {
    return null;
  }

  // Удаляем символ #, если он есть.
  hex = hex.replace("#", "");

  // Разбираем HEX цвет на компоненты.
  const r = parseInt(hex.substring(0, 2), 16);
  const g = parseInt(hex.substring(2, 4), 16);
  const b = parseInt(hex.substring(4, 6), 16);

  // Возвращаем RGBA цвет.
  return `rgba(${r}, ${g}, ${b}, ${alpha})`;
}

/**
 * Получает RGBA цвет ячейки.
 *
 * @param {string} sheetName Имя листа.
 * @param {number} row Номер строки.
 * @param {number} column Номер столбца.
 * @param {number} alpha Прозрачность (от 0 до 1).
 * @return {string} RGBA цвет ячейки.
 */
function getCellBackgroundColorRgba(sheetName, row, column, alpha) {
  const hexColor = getCellBackgroundColorHex(sheetName, row, column);
  if (!hexColor) {
    return null;
  }
  return hexToRgba(hexColor, alpha);
}

// Пример использования
function exampleRgbaUsage() {
  const rgbaColor = getCellBackgroundColorRgba("Лист1", 1, 1, 0.5);
  Logger.log(rgbaColor);
}

/**
 * Триггер, который запускается при изменении листа.
 *
 * @param {Object} e Объект события.
 */
function onEdit(e) {
  // Получаем лист, на котором произошло изменение.
  const sheet = e.range.getSheet();
  // Проверяем, что изменение произошло на нужном листе.
  if (sheet.getName() !== "Лист1") return;

  // Проверяем, что изменена ячейка A1.
  if (e.range.rowStart === 1 && e.range.columnStart === 1) {
    // Получаем новый цвет ячейки A1.
    const newColor = sheet.getRange(1, 1).getBackground();

    // Устанавливаем этот цвет для ячейки B1.
    sheet.getRange(1, 2).setBackground(newColor);
  }
}

/**
 * Создает отчет по неэффективным ключевым словам.
 */
function createReport() {
  const sheetName = "Лист1";
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);
  if (!sheet) {
    Logger.log("Лист с именем '" + sheetName + "' не найден.");
    return;
  }

  const lastRow = sheet.getLastRow();
  const report = [];

  // Проходим по каждой строке.
  for (let i = 1; i <= lastRow; i++) {
    // Получаем цвет фона ячейки в столбце A.
    const color = sheet.getRange(i, 1).getBackground();
    // Если цвет красный, добавляем ключевое слово в отчет.
    if (color === "#ff0000") { // Красный цвет
      const keyword = sheet.getRange(i, 1).getValue();
      report.push(keyword);
    }
  }

  // Выводим отчет в лог.
  Logger.log("Неэффективные ключевые слова: " + report.join(", "));
}

/**
 * Триггер, запускаемый при изменении данных в таблице.
 *
 * @param {object} e Объект события.
 */
function onEdit(e) {
  const range = e.range;
  const oldValue = e.oldValue;
  const newValue = range.getValue();
  const sheet = range.getSheet();
  const row = range.getRow();
  const column = range.getColumn();
  const backgroundColor = range.getBackground();
  
  // Логируем информацию об изменении.
  Logger.log(
    `Изменение на листе: ${sheet.getName()}, Строка: ${row}, Столбец: ${column}, ` +
    `Старое значение: ${oldValue}, Новое значение: ${newValue}, Цвет фона: ${backgroundColor}`
  );
}

const color = sheet.getRange(1, 1).getBackground();
if (color === "") {
  // Цвет не задан
  Logger.log("Цвет ячейки не задан");
} else {
  // Цвет задан
  Logger.log("Цвет ячейки: " + color);
}