appendRows

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

Wird ein Blatt übergeben, zählt das ganze Blatt und geschrieben wird ab Spalte 1; wird ein Bereich übergeben, zählen nur dessen Zellen und geschrieben wird auf seinen Spalten — Daten anderswo im Blatt bestimmen die Stelle dann nicht mehr.

Nichts wird überschrieben: geschrieben wird eine Zeile unter der letzten mit Daten, wobei 0 und false als Daten gelten. Ist das Blatt zu kurz, erhält es weitere Zeilen. Anders als Sheet#appendRow, das eine Zeile nach der anderen nimmt, wird der ganze Block in einem Aufruf geschrieben.

Eine Zelle, deren Text mit = beginnt, wird als Formel geschrieben, nicht als Text — dieselbe Regel wie im Editor.

Ein Fehler beim Schreiben — Dienst nicht verfügbar, Blatt gelöscht — kommt als der Fehler zurück, den der Dienst geworfen hat, samt Stack. Die Dokumentsperre wird in jedem Fall freigegeben.

Parameter

Parameter	Typ	Beschreibung
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Das Blatt, an das angefügt wird, oder der Bereich, innerhalb dessen angefügt wird.
`values`	`unknown`	Eine Matrix aus Zeilen: ein Array je Zeile, alle gleich lang.
`options` (optional) `= {}`	`AppendRowsOptions \\| null \\| undefined`	`afterFrozenRows` beginnt unter den fixierten Zeilen, wenn die Daten davor enden.

Rückgabewert

GoogleAppsScript.Spreadsheet.Sheet — das Blatt, sodass Aufrufe verkettet werden können.

Ausnahmen

Ausnahme	Bedingung
`IllegalArgumentException`	kein Argument übergeben wurde.
`InvalidSheetException`	das erste Argument weder ein Blatt noch ein Bereich ist.
`TypeError`	die Werte keine Matrix mit gleich langen Zeilen sind.

Beispiele

An ein Blatt anfügen

const sheet = SpreadsheetApp.getActiveSheet();

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

Innerhalb eines Bereichs anfügen

const sheet = SpreadsheetApp.getActiveSheet();

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

Siehe auch

Quellcode

src/appsscript/sheet/appendRows.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.