getValues

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

Avec headerRow, chaque ligne arrive sous forme d'objet dont les clés sont les noms de colonnes, ce qui rend un filtre lisible : row.status plutôt que row[4]. Si un nom se répète, la colonne la plus à gauche l'emporte.

filter restreint les lignes, offset et limit paginent le reste, et mapper décide de ce que devient chaque ligne conservée. display lit les valeurs telles qu'une personne les voit — une date formatée comme du texte plutôt que comme un Date — ce qui est un autre contenu, pas un réglage cosmétique.

Une feuille lit toute sa plage de données ; une plage ne lit qu'elle-même — un appel de service sur un bloc plutôt que sur tout. Les positions restent indexées depuis 1 dans la feuille : une ligne garde son vrai numéro, et headerRow désigne une ligne de la feuille, pas un décalage dans la plage.

Paramètres

Paramètre	Type	Description
`target`	`GoogleAppsScript.Spreadsheet.Sheet \\| GoogleAppsScript.Spreadsheet.Range`	La feuille à lire, ou la plage à lire : seules ses cellules sont récupérées.
`config` (facultatif) `= {}`	`GetValuesConfig \\| null \\| undefined`	`headerRow`, `display`, `filter`, `offset`, `limit` et `mapper`.

Valeur de retour

T[] — les lignes conservées, dans l'ordre de la feuille.

Exceptions

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

Exemples

Lire des lignes

const sheet = SpreadsheetApp.getActiveSheet();

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

Lire un seul bloc

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 });

Voir aussi

Code source

src/appsscript/sheet/getValues.ts

23 September 2026

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