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) на основі вихідного коду бібліотеки.