getValues

function getValues<T = unknown>(
  target: GoogleAppsScript.Spreadsheet.Sheet | GoogleAppsScript.Spreadsheet.Range,
  config: GetValuesConfig | null | undefined = {}
): T[];

Если задан headerRow, каждая строка приходит объектом с ключами по именам столбцов — именно это делает фильтр читаемым: row.status вместо row[4]. При повторе имени побеждает левый столбец.

filter сужает набор строк, offset и limit разбивают оставшееся на страницы, а mapper решает, во что превращается каждая уцелевшая строка. display читает значения так, как их видит человек: отформатированную дату — как текст, а не как Date. Это другое содержимое, а не косметика.

Лист читает весь свой диапазон данных; диапазон читает только себя — это один вызов сервиса по блоку вместо всего листа. Позиции остаются одноосновными по листу, поэтому у строки сохраняется её настоящий номер, а headerRow указывает строку листа, а не смещение внутри диапазона.

Параметры

Параметр	Тип	Описание
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	Лист, который читаем, или диапазон, который читаем: забираются только его ячейки.
`config` (необязательный) `= {}`	`GetValuesConfig \\| null \\| undefined`	`headerRow`, `display`, `filter`, `offset`, `limit` и `mapper`.

Возвращает

T[] — уцелевшие строки в порядке листа.

Исключения

Исключение	Условие
`InvalidSheetException`	первый аргумент не является ни листом, ни диапазоном.

Примеры

Чтение строк

const sheet = SpreadsheetApp.getActiveSheet();

const active = getValues(sheet, {
  headerRow: 1,
  filter: (row) => row.status === "active",
  mapper: (row) => row.email,
  limit: 100
});

Чтение одного блока

const sheet = SpreadsheetApp.getActiveSheet();

// Only A1:C50 is fetched; the header is row 1 of the sheet.
const rows = getValues(sheet.getRange("A1:C50"), { headerRow: 1 });

Смотрите также

Исходный код

src/appsscript/sheet/getValues.ts

23 September 2026

Эта документация сгенерирована нейросетью (Claude) на основе исходного кода библиотеки.