appendRows

function appendRows(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  values: unknown,
  options: AppendRowsOptions | null | undefined = {}
): GoogleAppsScript.Spreadsheet.Sheet;

Передан лист — просматривается весь лист, запись начинается со столбца 1; передан диапазон — только его ячейки, и запись идёт по столбцам диапазона: данные в других местах листа больше не решают, куда попадёт блок.

Ничего не перезаписывается: запись начинается строкой ниже последней, где есть данные, причём 0 и false считаются данными. Если листу не хватает высоты, строки добавляются. В отличие от Sheet#appendRow, который принимает по одной строке, весь блок пишется за один вызов.

Ячейка, текст которой начинается с =, записывается как формула, а не как текст — по тому же правилу, что и в редакторе.

Сбой внутри записи — сервис недоступен, лист удалён — возвращается тем самым исключением, которое бросил сервис, вместе со стеком. Блокировка документа снимается в любом случае.

Параметры

Параметр	Тип	Описание
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Лист, в который добавляем, или диапазон, внутри которого добавляем.
`values`	`unknown`	Матрица строк: по массиву на строку, все одной длины.
`options` (необязательный) `= {}`	`AppendRowsOptions \\| null \\| undefined`	`afterFrozenRows` начинает запись ниже закреплённых строк, если данные заканчиваются раньше них.

Возвращает

GoogleAppsScript.Spreadsheet.Sheet — лист, чтобы вызовы можно было объединять в цепочку.

Исключения

Исключение	Условие
`IllegalArgumentException`	не передан ни один аргумент.
`InvalidSheetException`	первый аргумент не является ни листом, ни диапазоном.
`TypeError`	значения не являются матрицей со строками одинаковой длины.

Примеры

Добавление на лист

const sheet = SpreadsheetApp.getActiveSheet();

appendRows(sheet, [
  ["Ada", "ada@example.com"],
  ["Grace", "grace@example.com"]
]);

Добавление внутри диапазона

const sheet = SpreadsheetApp.getActiveSheet();

appendRows(sheet.getRange("B1:C10"), [["Ada", "ada@example.com"]]);

Смотрите также

Исходный код

src/appsscript/sheet/appendRows.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.