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