insertSchema

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

Das Schema wird in die Developer-Metadaten des Blattes geschrieben und reist damit mit: eine Kopie der Tabelle trägt es mit sich, und getSchema findet es wieder, ohne eine Zelle zu lesen.

Die Beschreibung wird zugleich umgesetzt: die Kopfzeile wird geschrieben und die Spalten bekommen Formatierung und Datenprüfung, die sich aus ihren Typen ergeben.

Parameter

Parameter	Typ	Beschreibung
`sheet`	`GoogleAppsScript.Spreadsheet.Sheet`	Das Blatt, auf dem gearbeitet wird.
`schema`	`SheetSchema`	Das Schema: `version`, `headerRow` und `columns`.

Rückgabewert

GoogleAppsScript.Spreadsheet.Sheet — dasselbe Blatt.

Ausnahmen

Ausnahme	Bedingung
`InvalidSheetException`	das erste Argument ist kein Blatt.

Beispiele

Ein Schema festlegen

const sheet = SpreadsheetApp.getActiveSheet();

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

Siehe auch

Quellcode

src/appsscript/sheet/insertSchema.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.