appendColumn

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

Les valeurs remplissent la colonne vers le bas : une valeur par ligne. Une feuille est examinée entièrement et la colonne est écrite à partir de la ligne 1 ; une plage n'est examinée qu'en elle-même et la colonne est écrite sur ses lignes, à droite de la dernière colonne de la plage contenant des données.

C'est appendColumns avec une seule colonne : 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 colonne : un tableau plat, une valeur par ligne.
`options` (facultatif) `= {}`	`Options \\| null \\| undefined`	`afterFrozenColumns` commence l'écriture après les colonnes 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();

appendColumn(sheet, ["status", "new", "new"]);

Ajout dans une plage

const sheet = SpreadsheetApp.getActiveSheet();

appendColumn(sheet.getRange("A1:D3"), ["status", "new", "new"]);

Voir aussi

Code source

src/appsscript/sheet/appendColumn.ts

23 September 2026

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