Google Apps Script: Как скопировать диапазон данных в другой лист?

03.06.2025
18546

8 мин
421

Google Apps Script (GAS) предоставляет мощные возможности для автоматизации и расширения функциональности Google Workspace, включая Google Sheets. Одной из частых задач является перенос данных между листами или даже разными таблицами. Понимание того, как эффективно копировать диапазоны, критически важно для создания надежных и производительных скриптов.

Саммари статьи

ChatGPT

Google AI

Grok

Perplexity

Что такое Google Apps Script и зачем он нужен для работы с Google Sheets?

Google Apps Script — это облачная платформа для скриптов на основе JavaScript, позволяющая автоматизировать задачи в сервисах Google. В контексте Google Sheets, GAS позволяет манипулировать данными, форматированием, создавать пользовательские функции, меню, триггеры и взаимодействовать с внешними сервисами.

Основные понятия: Spreadsheet, Sheet, Range в контексте Apps Script

Для работы с данными в Google Sheets через Apps Script необходимо понимать иерархию объектов:

Spreadsheet: Представляет всю таблицу Google Sheets (файл).
Sheet: Представляет отдельный лист внутри таблицы.
Range: Представляет прямоугольную область ячеек на листе (одна ячейка, строка, столбец или блок ячеек).

Обзор методов для получения доступа к данным в Google Sheets

Доступ к этим объектам осуществляется с помощью сервиса SpreadsheetApp:

SpreadsheetApp.getActiveSpreadsheet(): Получает активную (открытую) таблицу.
SpreadsheetApp.openById(id) / SpreadsheetApp.openByUrl(url): Открывает таблицу по ID или URL.
spreadsheet.getSheetByName(name): Получает лист по имени.
spreadsheet.getSheets(): Получает массив всех листов.
sheet.getRange(row, column, numRows, numColumns) / sheet.getRange(a1Notation): Получает диапазон по координатам или A1-нотации.
sheet.getDataRange(): Получает диапазон, содержащий все данные на листе.

Основные методы копирования диапазонов

Существует два основных подхода к копированию данных между диапазонами с помощью Google Apps Script.

Использование `getValues()` и `setValues()` для копирования данных

Этот метод заключается в получении данных из исходного диапазона в виде двумерного массива JavaScript, а затем записи этого массива в целевой диапазон. Копируется только содержимое ячеек, без форматирования, формул (копируются результаты вычислений) или примечаний.

Пример кода: копирование диапазона из листа A в лист B

/**
 * Копирует значения из исходного диапазона в целевой диапазон на другом листе.
 *
 * @param {SpreadsheetApp.Sheet} sourceSheet Лист-источник.
 * @param {string} sourceRangeA1 A1-нотация диапазона-источника (например, "A1:C10").
 * @param {SpreadsheetApp.Sheet} targetSheet Целевой лист.
 * @param {string} targetStartCellA1 A1-нотация начальной ячейки целевого диапазона (например, "A1").
 */
function copyValuesOnly(sourceSheet, sourceRangeA1, targetSheet, targetStartCellA1) {
  try {
    const sourceRange = sourceSheet.getRange(sourceRangeA1);
    const values = sourceRange.getValues(); // Получаем двумерный массив значений

    if (values.length === 0 || values[0].length === 0) {
      console.warn('Исходный диапазон пуст или не найден: ' + sourceRangeA1);
      return;
    }

    // Определяем целевой диапазон по размерам исходного
    const targetRange = targetSheet.getRange(
      targetSheet.getRange(targetStartCellA1).getRow(),
      targetSheet.getRange(targetStartCellA1).getColumn(),
      values.length, // Количество строк
      values[0].length // Количество столбцов
    );

    targetRange.setValues(values); // Записываем массив значений
    console.log(`Данные успешно скопированы из ${sourceSheet.getName()}!${sourceRangeA1} в ${targetSheet.getName()}!${targetRange.getA1Notation()}`);

  } catch (error) {
    console.error(`Ошибка при копировании данных: ${error.message}`);
    console.error(error.stack);
  }
}

// Пример использования:
function runCopyValues() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = ss.getSheetByName('Лист_Источника'); // Замените на имя вашего листа
  const targetSheet = ss.getSheetByName('Лист_Назначения'); // Замените на имя вашего листа

  if (!sourceSheet || !targetSheet) {
    console.error('Один из листов не найден. Проверьте имена листов.');
    return;
  }

  copyValuesOnly(sourceSheet, 'A1:D10', targetSheet, 'B2');
}

Использование `copyTo()` для копирования данных и форматирования

Метод Range.copyTo(destination, options) копирует исходный диапазон в указанный целевой диапазон. Этот метод более универсален, так как позволяет копировать не только значения, но и форматирование, проверку данных, условное форматирование и т.д.

Параметр options (необязательный объект) позволяет указать, что именно нужно копировать (например, contentsOnly: true для имитации getValues()/setValues()).

/**
 * Копирует диапазон с форматированием в указанное место.
 *
 * @param {SpreadsheetApp.Range} sourceRange Исходный диапазон.
 * @param {SpreadsheetApp.Range} targetStartRange Целевой диапазон (достаточно указать верхнюю левую ячейку).
 * @param {object} [copyOptions] Опции копирования (например, {contentsOnly: true}).
 */
function copyRangeWithFormatting(sourceRange, targetStartRange, copyOptions) {
  try {
    // Если целевой диапазон больше одной ячейки, берем только верхнюю левую
    const destination = targetStartRange.getCell(1, 1);

    if (copyOptions) {
      sourceRange.copyTo(destination, copyOptions);
      console.log(`Диапазон ${sourceRange.getA1Notation()} скопирован в ${destination.getA1Notation()} с опциями: ${JSON.stringify(copyOptions)}`);
    } else {
      sourceRange.copyTo(destination);
      console.log(`Диапазон ${sourceRange.getA1Notation()} полностью скопирован в ${destination.getA1Notation()}`);
    }
  } catch (error) {
    console.error(`Ошибка при копировании диапазона: ${error.message}`);
    console.error(error.stack);
  }
}

// Пример использования:
function runCopyFormatting() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = ss.getSheetByName('Отчет_Маркетинг');
  const targetSheet = ss.getSheetByName('Архив_Отчетов');

  if (!sourceSheet || !targetSheet) {
    console.error('Один из листов не найден.');
    return;
  }

  const sourceRange = sourceSheet.getRange('B2:G25'); // Диапазон с данными кампании
  const targetStartRange = targetSheet.getRange('A50'); // Начало для вставки архива

  // Копировать все (значения, форматирование, и т.д.)
  copyRangeWithFormatting(sourceRange, targetStartRange);

  // Копировать только значения (эквивалентно getValues/setValues)
  // copyRangeWithFormatting(sourceRange, targetStartRange, { contentsOnly: true });
}

Сравнение `getValues()/setValues()` и `copyTo()`: преимущества и недостатки

getValues()/setValues():*
- Преимущества: Дает полный контроль над данными перед записью (можно модифицировать массив values), часто работает быстрее для очень больших диапазонов при копировании только значений.
- Недостатки: Не копирует форматирование, формулы (копирует результат), примечания. Требует явного указания размера целевого диапазона.
copyTo():*
- Преимущества: Копирует форматирование, формулы, проверку данных и т.д. (если не указано иное в options). Проще в использовании для полного клонирования диапазона. Целевой диапазон создается автоматически по размеру исходного, начиная с указанной ячейки.
- Недостатки: Меньше гибкости при необходимости манипулировать данными во время копирования. Может быть медленнее при полном копировании сложных форматов.

Выбор метода зависит от задачи: нужно ли только содержимое или полное копирование ячеек.

Копирование диапазонов с учетом различных условий

Часто требуется копировать не весь диапазон, а только его часть, отвечающую определенным критериям.

Копирование только определенных столбцов или строк

Через getValues()/setValues(): Получите весь диапазон с помощью getValues(), затем в цикле или с помощью методов массивов (map, filter) создайте новый массив, содержащий только нужные строки/столбцы, и запишите его с помощью setValues().
Через copyTo(): Невозможно напрямую скопировать несмежные столбцы/строки одним вызовом copyTo(). Придется либо копировать каждый нужный столбец/строку отдельно (неэффективно), либо скопировать все, а затем удалить ненужное, либо использовать getValues()/setValues().

Копирование данных на основе критериев (например, копирование только строк, где значение в столбце X равно Y)

Это классическая задача фильтрации. Наиболее эффективный способ — использовать getValues() и метод Array.prototype.filter().

Пример кода: копирование данных с фильтрацией

Предположим, у нас есть лист ‘Лиды’ со столбцами ‘Имя’, ‘Email’, ‘Статус’, ‘Источник’. Мы хотим скопировать всех лидов со статусом ‘Квалифицирован’ на лист ‘Квалифицированные_Лиды’.

/**
 * Копирует строки из исходного листа в целевой на основе значения в указанном столбце.
 *
 * @param {SpreadsheetApp.Sheet} sourceSheet Исходный лист.
 * @param {SpreadsheetApp.Sheet} targetSheet Целевой лист.
 * @param {number} filterColumnIndex Индекс столбца для фильтрации (1-based).
 * @param {string | number | boolean} filterValue Значение для фильтрации.
 * @param {boolean} [includeHeader=true] Копировать ли строку заголовка.
 */
function copyFilteredData(sourceSheet, targetSheet, filterColumnIndex, filterValue, includeHeader = true) {
  try {
    const sourceDataRange = sourceSheet.getDataRange();
    const sourceValues = sourceDataRange.getValues();

    if (sourceValues.length < (includeHeader ? 2 : 1)) {
      console.warn(`На листе ${sourceSheet.getName()} нет данных для копирования.`);
      return;
    }

    const headerRow = includeHeader ? sourceValues[0] : null;
    const dataRows = includeHeader ? sourceValues.slice(1) : sourceValues;

    // Фильтруем строки
    const filteredRows = dataRows.filter(row => {
      // Проверяем, что в строке достаточно столбцов и значение совпадает
      return row.length >= filterColumnIndex && row[filterColumnIndex - 1] === filterValue;
    });

    if (filteredRows.length === 0) {
      console.log(`Не найдено строк со значением '${filterValue}' в столбце ${filterColumnIndex} на листе ${sourceSheet.getName()}.`);
      return;
    }

    const outputData = includeHeader && headerRow ? [headerRow, ...filteredRows] : filteredRows;

    // Очищаем целевой лист (опционально, зависит от задачи)
    // targetSheet.getDataRange().clearContents();

    // Записываем отфильтрованные данные
    targetSheet.getRange(1, 1, outputData.length, outputData[0].length).setValues(outputData);
    console.log(`Скопировано ${filteredRows.length} строк на лист ${targetSheet.getName()}.`);

  } catch (error) {
    console.error(`Ошибка при копировании отфильтрованных данных: ${error.message}`);
    console.error(error.stack);
  }
}

// Пример использования:
function runFilteredCopy() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = ss.getSheetByName('Лиды');
  const targetSheet = ss.getSheetByName('Квалифицированные_Лиды');

  if (!sourceSheet || !targetSheet) {
    console.error('Один из листов не найден.');
    return;
  }

  // Копировать строки, где в 3-м столбце ('Статус') значение 'Квалифицирован'
  const statusColumnIndex = 3; // Предполагаем, что 'Статус' - это 3-й столбец (C)
  copyFilteredData(sourceSheet, targetSheet, statusColumnIndex, 'Квалифицирован', true);
}

Расширенные сценарии и оптимизация

Копирование данных между разными Google Sheets (из одной таблицы в другую)

Для копирования между разными файлами Google Sheets необходимо сначала открыть обе таблицы:

function copyBetweenSpreadsheets() {
  const sourceSpreadsheetId = 'ID_ИСХОДНОЙ_ТАБЛИЦЫ';
  const targetSpreadsheetId = 'ID_ЦЕЛЕВОЙ_ТАБЛИЦЫ';

  try {
    const sourceSs = SpreadsheetApp.openById(sourceSpreadsheetId);
    const targetSs = SpreadsheetApp.openById(targetSpreadsheetId);

    const sourceSheet = sourceSs.getSheetByName('Данные_Экспорт');
    const targetSheet = targetSs.getSheetByName('Данные_Импорт');

    if (!sourceSheet || !targetSheet) {
      console.error('Лист не найден в одной из таблиц.');
      return;
    }

    // Используем ранее определенные функции копирования
    // Например, копируем только значения:
    const sourceRange = sourceSheet.getRange('A1:Z1000');
    const values = sourceRange.getValues();
    if (values.length > 0 && values[0].length > 0) {
         targetSheet.getRange(1, 1, values.length, values[0].length).setValues(values);
         console.log('Данные скопированы между таблицами.');
    } else {
        console.log('Нет данных для копирования в исходном диапазоне.');
    }

    // Или копируем с форматированием (менее предпочтительно между разными таблицами из-за возможных проблем со стилями)
    // const sourceRange = sourceSheet.getRange('A1:F50');
    // const targetStartRange = targetSheet.getRange('A1');
    // copyRangeWithFormatting(sourceRange, targetStartRange);

  } catch (error) {
    console.error(`Ошибка при копировании между таблицами: ${error.message}`);
    console.error(error.stack);
  }
}

Обработка больших объемов данных: советы по оптимизации скрипта

Работа с большими диапазонами может приводить к превышению лимитов времени выполнения скрипта (обычно 6 минут для стандартных аккаунтов).

Минимизируйте вызовы API: Старайтесь читать (getValues) и записывать (setValues, copyTo) данные как можно большими блоками, а не ячейка за ячейкой или строка за строкой.
Используйте getDataRange(): Если нужно обработать все данные на листе, getDataRange() эффективнее, чем определение диапазона вручную.
Обработка в JavaScript: Выполняйте фильтрацию, трансформацию данных в массивах JavaScript (getValues() -> обработка -> setValues()), так как это значительно быстрее, чем многократные обращения к SpreadsheetApp.
Разбиение на части (Batching): Если данные очень большие, рассмотрите возможность обработки их частями с использованием триггеров или сохранения состояния между запусками (например, с помощью PropertiesService).
SpreadsheetApp.flush(): Используйте SpreadsheetApp.flush() умеренно, если нужно принудительно применить изменения перед следующим шагом, но помните, что это синхронный вызов, который может замедлить скрипт.

Обработка ошибок и логирование: как сделать скрипт более надежным

try...catch: Оборачивайте основной код, особенно операции ввода-вывода (работа с листами, диапазонами), в блоки try...catch для перехвата и обработки потенциальных ошибок (например, лист не найден, нет прав доступа).
Логирование: Используйте Logger.log() (для отладки в редакторе) или console.log() (логируется в Stackdriver/Google Cloud Logging, предпочтительнее для мониторинга) для записи статуса выполнения, ошибок и значений переменных. Это неоценимо при отладке и мониторинге работы скриптов, особенно выполняющихся по триггеру.
Проверки: Перед использованием объектов (Sheet, Range) проверяйте, что они были успешно получены (не равны null).

Заключение и полезные ресурсы

Обзор рассмотренных методов и лучших практик

Мы рассмотрели два основных метода копирования диапазонов в Google Apps Script: getValues()/setValues() для копирования только данных и copyTo() для копирования данных вместе с форматированием. Выбор зависит от конкретной задачи. Для условного копирования эффективнее всего использовать getValues(), фильтрацию массива в JavaScript и setValues(). При работе с большими объемами данных ключевое значение имеют минимизация вызовов API и пакетная обработка. Надежность скрипта обеспечивается грамотной обработкой ошибок и логированием.

Дополнительные ресурсы для изучения Google Apps Script и работы с Google Sheets

Официальная документация Google Apps Script: https://developers.google.com/apps-script/ (Особенно разделы Spreadsheet Service)
Справочник по Spreadsheet Service: https://developers.google.com/apps-script/reference/spreadsheet
Примеры кода и руководства: https://developers.google.com/apps-script/samples/

Используя эти методы и лучшие практики, вы сможете эффективно управлять данными в Google Sheets с помощью Google Apps Script.

Добавить комментарий

Как правильно использовать блочные комментарии в Google Apps Script для чистого кода?

В мире разработки программного обеспечения, где чистота и поддерживаемость кода ценятся не меньше его функциональности, комментарии играют ключевую роль.

21
2026

Расширение функционала Google Диска с помощью Google Apps Script: подробное руководство и примеры автоматизации

Google Диск является неотъемлемой частью цифровой экосистемы для миллионов пользователей и организаций, предлагая надежное хранилище и удобные инструменты для совместной работы.

21
2026

Как превратить стандартный редактор Google Apps Script в мощную IDE: вопросы и решения?

Google Apps Script является незаменимым инструментом для автоматизации задач в экосистеме Google Workspace, позволяя разработчикам и продвинутым пользователям создавать мощные решения.

21
2026