appendColumn

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

Значення заповнюють стовпець згори вниз: по значенню на рядок. Аркуш переглядається цілком, і стовпець пишеться з першого рядка; діапазон переглядається лише всередині себе, і стовпець пишеться за його рядками, праворуч від останнього стовпця діапазону, де є дані.

Це appendColumns з одним стовпцем: ті самі перевірки, те саме розширення аркуша, якщо результат не вміщується, і те саме правило, що клітинка, яка починається з =, стає формулою.

Параметри

Параметр	Тип	Опис
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Аркуш, до якого додаємо, або діапазон, усередині якого додаємо.
`values`	`unknown`	Один стовпець: плоский масив, по значенню на рядок.
`options` (необов'язковий) `= {}`	`Options \\| null \\| undefined`	`afterFrozenColumns` починає запис після закріплених стовпців, якщо дані закінчуються раніше за них.

Повертає

GoogleAppsScript.Spreadsheet.Sheet — аркуш, щоб виклики можна було об'єднувати в ланцюжок.

Винятки

Виняток	Умова
`IllegalArgumentException`	не передано жодного аргументу.
`InvalidSheetException`	перший аргумент не є ні аркушем, ні діапазоном.
`TypeError`	значення не є плоским масивом.

Приклади

Додавання на аркуш

const sheet = SpreadsheetApp.getActiveSheet();

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

Додавання всередині діапазону

const sheet = SpreadsheetApp.getActiveSheet();

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

Дивіться також

Вихідний код

src/appsscript/sheet/appendColumn.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.