Avant de nous lancer dans l'apprentissage des bases de Google App Script, il est important d'identifier et nommer correctement les différentes composantes que nous allons devoir manipuler.
Pour commencer, nous devons faire la distinction entre un SpreadSheet et une Sheet.
Pour les personnes qui ont l'habitude de travailler avec les feuilles de calcul de la suite Google, on parle généralement de "Google Sheet" pour faire référence à un fichier Google Sheet, c'est-à-dire un document Google Sheet. Du fait de l'utilisation de cette appellation, la confusion est grande lorsqu'on découvre Google App Script.
La copie d'écran ci-dessous n'affiche pas 3 Google Sheets dans le dossier voxpedago, mais 3 SpeadSheets.
En revanche, lorsqu'on ouvre le Google document Google App Script de type SpreadSheet, nous pouvons découvrir qu'il contient 4 feuilles de calcul auxquelles on accède via des onglets.
<aside> 💡 En informatique, nous manipulons des applications, des répertoires ou dossiers) et des documents (qui sont des fichiers). Un document peut être un fichier contenant du texte, des pixels, des images, du son, etc., mais dans la suite Google, on fait la distinction entre un Google Document qui est un document contenant du texte (comme un document Word) et une Google Sheet qui contient des tableaux.
</aside>
À partir de maintenant, dans Google App Script, vous devez donc faire la différence entre le terme SpreadSheet qui désigne un document (contenant un tableau) Google et le terme Sheet qui désigne une partie d'un SpreadSheet.
Nous n'utiliserons dons pas ici le terme feuille de calcul pour faire référence à un SpreadSheet, car nous voulons rester cohérent avec la terminologie employée dans Google App Script. Message personnel de l'auteur de cet article : je n'utilise jamais le terme SpreadSheet pour faire référence à ce que j'appelle une feuille de calcul.
Lorsque vous travaillez sur/dans une Sheet, dans un SpreadSheet, vous remplissez des cellules contenues dans des lignes et des colonnes. À l'intérieur d'une cellule, vous pouvez écrire une formule comme celle-ci :