appendRow

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

Une feuille est examinée entièrement et la ligne est écrite à partir de la colonne 1 ; une plage n'est examinée qu'en elle-même et la ligne est écrite sur ses colonnes, sous la dernière ligne de la plage contenant des données.

C'est appendRows avec une seule ligne : mêmes garde-fous, même agrandissement de la feuille si le résultat n'y tient pas, et même règle qu'une cellule commençant par = devient une formule.

Paramètres

Paramètre	Type	Description
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	La feuille à laquelle ajouter, ou la plage dans laquelle ajouter.
`values`	`unknown`	Une seule ligne : un tableau plat, une valeur par colonne.
`options` (facultatif) `= {}`	`AppendRowsOptions \\| null \\| undefined`	`afterFrozenRows` commence l'écriture sous les lignes figées lorsque les données s'arrêtent avant elles.

Valeur de retour

GoogleAppsScript.Spreadsheet.Sheet — la feuille, afin de chaîner les appels.

Exceptions

Exception	Condition
`IllegalArgumentException`	aucun argument n'est passé.
`InvalidSheetException`	le premier argument n'est ni une feuille ni une plage.
`TypeError`	les valeurs ne forment pas un tableau plat.

Exemples

Ajout à une feuille

const sheet = SpreadsheetApp.getActiveSheet();

appendRow(sheet, ["Ada", "ada@example.com", "=TODAY()"]);

Ajout dans une plage

const sheet = SpreadsheetApp.getActiveSheet();

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

Voir aussi

Code source

src/appsscript/sheet/appendRow.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.