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