Как отформатировать ячейки в Google Apps Script: Полное руководство

Обзор возможностей форматирования в Google Sheets API

Google Apps Script предоставляет мощные инструменты для автоматизации работы с Google Sheets, включая широкие возможности форматирования ячеек. Через Apps Script можно управлять практически всеми аспектами внешнего вида ячеек, от шрифта и цвета до числовых форматов и условного форматирования. Это позволяет создавать сложные и информативные отчеты, автоматизировать визуализацию данных и значительно упростить рутинные задачи.

Необходимые условия и настройка среды разработки

Для работы с Google Apps Script необходим аккаунт Google и доступ к Google Sheets. Разработка ведется непосредственно в браузере через редактор Apps Script, который можно открыть из Google Sheets (Инструменты -> Редактор скриптов). Знакомство с основами JavaScript также будет полезным, так как Apps Script основан на JavaScript.

Подключение к Google Sheets с использованием Apps Script

Для доступа к таблице необходимо получить ее объект с помощью SpreadsheetApp.getActiveSpreadsheet() (для активной таблицы) или SpreadsheetApp.openById(id) (для таблицы по ее ID). Затем можно получить доступ к конкретному листу с помощью spreadsheet.getSheetByName(name) или spreadsheet.getActiveSheet().

Основные методы форматирования ячеек

Изменение шрифта (размер, начертание, цвет)

Изменение шрифта, размера, начертания и цвета текста – базовая задача при форматировании. Вот пример:

/**
 * @param {string} sheetName Name of the sheet to format.
 * @param {string} range Notation of the range to format (e.g., "A1:B10").
 * @param {number} fontSize Size of the font in points.
 * @param {string} fontColor Hexadecimal color code (e.g., "#FF0000" for red).
 */
function formatFont(sheetName, range, fontSize, fontColor) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(sheetName);
  const cellRange = sheet.getRange(range);

  cellRange.setFontSize(fontSize);
  cellRange.setFontColor(fontColor);
}

// Example usage
formatFont("Sheet1", "A1:A5", 12, "#0000FF"); // Set font size 12 and blue color

Методы setFontFamily(), setFontWeight() (например, `