insertSchema

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

Le schéma est écrit dans les métadonnées développeur de la feuille : il voyage donc avec elle — une copie du classeur l'emporte, et getSchema le retrouve sans lire une seule cellule.

La description est aussi mise en œuvre : la ligne d'en-tête est écrite et les colonnes reçoivent le format et la validation qu'impliquent leurs types.

Paramètres

Paramètre	Type	Description
`sheet`	`GoogleAppsScript.Spreadsheet.Sheet`	La feuille sur laquelle travailler.
`schema`	`SheetSchema`	Le schéma : `version`, `headerRow` et `columns`.

Valeur de retour

GoogleAppsScript.Spreadsheet.Sheet — la même feuille.

Exceptions

Exception	Condition
`InvalidSheetException`	le premier argument n'est pas une feuille.

Exemples

Déclarer un schéma

const sheet = SpreadsheetApp.getActiveSheet();

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

Voir aussi

Code source

src/appsscript/sheet/insertSchema.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.