insertSchema

function insertSchema(
  sheet: GoogleAppsScript.Spreadsheet.Sheet,
  schema: SheetSchema
): GoogleAppsScript.Spreadsheet.Sheet;

Схема записывается в developer metadata листа, поэтому путешествует вместе с ним: копия таблицы её сохраняет, а getSchema находит её, не читая ни одной ячейки.

Описание при этом применяется: пишется строка заголовков, а столбцы получают форматирование и проверку данных, которые следуют из их типов.

Параметры

Параметр	Тип	Описание
`sheet`	`GoogleAppsScript.Spreadsheet.Sheet`	Лист, с которым работаем.
`schema`	`SheetSchema`	Схема: `version`, `headerRow` и `columns`.

Возвращает

GoogleAppsScript.Spreadsheet.Sheet — тот же лист.

Исключения

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

Примеры

Объявление схемы

const sheet = SpreadsheetApp.getActiveSheet();

insertSchema(sheet, {
  version: 1,
  headerRow: 1,
  columns: [
    { name: "id", type: "number" },
    { name: "email", type: "string" }
  ]
});

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

Исходный код

src/appsscript/sheet/insertSchema.ts

23 September 2026

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