Extension de Google Sheets

Google Apps Script vous permet de faire de nouvelles choses avec Google Sheets. Vous pouvez utiliser Apps Script pour ajouter des menus personnalisés, des boîtes de dialogue et des barres latérales à Google Sheets. Il vous permet également d'écrire des fonctions personnalisées pour Sheets et d'intégrer Sheets à d'autres services Google tels qu'Agenda, Drive et Gmail.

La plupart des scripts conçus pour manipuler des tableaux dans Google Sheets interagissent avec les cellules, les lignes et les colonnes d'une feuille de calcul. Si vous n'êtes pas familier avec les tableaux en JavaScript, Codecademy propose un module d'entraînement très pratique pour les tableaux. Notez que ce cours n'a pas été développé par et n'est pas associé à Google.

Pour une présentation rapide de l'utilisation d'Apps Script avec Google Sheets, consultez le guide de démarrage rapide (5 minutes) consacré aux macros, menus et fonctions personnalisées.

Premiers pas

Apps Script comprend des API spéciales qui vous permettent de créer, lire et modifier des feuilles de calcul Google Sheets par programmation. Apps Script peut interagir avec Google Sheets de deux manières différentes: tout script peut créer ou modifier une feuille de calcul si l'utilisateur du script dispose des autorisations appropriées pour la feuille de calcul, et un script peut également être lié à une feuille de calcul, ce qui lui donne les capacités spéciales de modifier l'interface utilisateur ou d'y répondre lorsque la feuille de calcul est ouverte. Pour créer un script lié, sélectionnez Extensions > Apps Script dans Google Sheets.

Le service Spreadsheet traite Google Sheets comme une grille qui fonctionne avec des tableaux à deux dimensions. Pour récupérer les données de la feuille de calcul, vous devez accéder à la feuille de calcul dans laquelle les données sont stockées, obtenir la plage de la feuille de calcul qui les contient, puis récupérer les valeurs des cellules. Apps Script facilite l'accès aux données en lisant les données structurées de la feuille de calcul et en créant des objets JavaScript.

Lire des données

Supposons que vous ayez une liste de noms et de numéros de produit que vous stockez dans une feuille de calcul, comme illustré ci-dessous.

L'exemple ci-dessous montre comment récupérer et consigner les noms et les numéros des produits.

function logProductInfo() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();
  for (var i = 0; i < data.length; i++) {
    Logger.log('Product name: ' + data[i][0]);
    Logger.log('Product number: ' + data[i][1]);
  }
}

Afficher les journaux

Nouvel éditeur

Pour afficher les données enregistrées, cliquez sur Journal d'exécution en haut de l'éditeur de scripts.

Ancien éditeur

Pour afficher les données enregistrées, sélectionnez Afficher les journaux dans l'éditeur de scripts.

Écrire des données

Pour stocker des données, telles qu'un nouveau nom de produit et un nouveau numéro dans la feuille de calcul, ajoutez le code suivant à la fin du script.

function addProduct() {
  var sheet = SpreadsheetApp.getActiveSheet();
  sheet.appendRow(['Cotton Sweatshirt XL', 'css004']);
}

Le code ci-dessus ajoute une ligne au bas de la feuille de calcul, avec les valeurs spécifiées. Si vous exécutez cette fonction, une nouvelle ligne est ajoutée à la feuille de calcul.

Menus personnalisés et interfaces utilisateur

Vous pouvez personnaliser Google Sheets en ajoutant des menus, des boîtes de dialogue et des barres latérales personnalisés. Pour apprendre les bases de la création de menus, consultez le guide des menus. Pour savoir comment personnaliser le contenu d'une boîte de dialogue, consultez le guide du service HTML.

Vous pouvez également associer une fonction de script à une image ou à un dessin dans une feuille de calcul. La fonction s'exécute lorsqu'un utilisateur clique sur l'image ou le dessin. Pour en savoir plus, consultez Images et dessins dans Google Sheets.

Si vous prévoyez de publier votre interface personnalisée dans le cadre d'un module complémentaire, suivez le guide de style pour plus de cohérence avec le style et la mise en page de l'éditeur Google Sheets.

Connexion à Google Forms

Apps Script vous permet de connecter Google Forms à Google Sheets via les services Forms et Sheets. Cette fonctionnalité peut créer automatiquement un formulaire Google Forms à partir des données d'une feuille de calcul. Apps Script vous permet également d'utiliser des déclencheurs tels que onFormSubmit pour effectuer une action spécifique après qu'un utilisateur a répondu au formulaire. Pour en savoir plus sur la connexion de Google Sheets à Google Forms, consultez le guide de démarrage rapide Gérer les réponses pour Google Forms en 5 minutes.

Mise en forme

La classe Range dispose de méthodes telles que setBackground(color) pour accéder au format d'une cellule ou pour modifier la mise en forme d'une cellule ou d'une plage de cellules. L'exemple suivant montre comment définir le style de police d'une plage:

function formatMySpreadsheet() {
  // Set the font style of the cells in the range of B2:C2 to be italic.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var cell = sheet.getRange('B2:C2');
  cell.setFontStyle('italic');
}

Validation des données

Apps Script vous permet d'accéder aux règles de validation des données existantes dans Google Sheets ou de créer des règles. Par exemple, l'exemple suivant montre comment définir une règle de validation des données qui n'autorise que des nombres compris entre 1 et 100 sur une cellule.

function validateMySpreadsheet() {
  // Set a rule for the cell B4 to be a number between 1 and 100.
  var cell = SpreadsheetApp.getActive().getRange('B4');
  var rule = SpreadsheetApp.newDataValidation()
     .requireNumberBetween(1, 100)
     .setAllowInvalid(false)
     .setHelpText('Number must be between 1 and 100.')
     .build();
  cell.setDataValidation(rule);
}

Pour en savoir plus sur l'utilisation des règles de validation des données, consultez SpreadsheetApp.newDataValidation(), DataValidationBuilder et Range.setDataValidation(rule).

Graphiques

Apps Script vous permet d'intégrer des graphiques dans une feuille de calcul qui représente les données d'une plage spécifique. L'exemple suivant génère un graphique à barres intégré, en partant du principe que vous disposez de données pouvant être représentées dans les cellules A1:B15:

function newChart() {
  // Generate a chart representing the data in the range of A1:B15.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
     .setChartType(Charts.ChartType.BAR)
     .addRange(sheet.getRange('A1:B15'))
     .setPosition(5, 5, 0, 0)
     .build();

  sheet.insertChart(chart);
}

Pour en savoir plus sur l'intégration d'un graphique dans votre feuille de calcul, consultez EmbeddedChart et des compilateurs de graphiques spécifiques, tels que EmbeddedPieChartBuilder.

Fonctions personnalisées dans Google Sheets

Une fonction personnalisée est semblable à une feuille de calcul intégrée telle que =SUM(A1:A5), à la différence que vous définissez le comportement de la fonction avec Apps Script. Par exemple, vous pouvez créer une fonction personnalisée, in2mm(), qui convertit une valeur en centimètres en millimètres, puis utiliser la formule dans votre feuille de calcul en saisissant =in2mm(A1) ou =in2mm(10) dans une cellule.

Pour en savoir plus sur les fonctions personnalisées, consultez le menu et les fonctions personnalisées guide de démarrage rapide de 5 minutes, ou consultez le guide plus complet sur les fonctions personnalisées.

Macros

Les macros sont un autre moyen d'exécuter du code Apps Script à partir de l'interface utilisateur de Google Sheets. Contrairement aux fonctions personnalisées, vous les activez à l'aide d'un raccourci clavier ou via le menu Google Sheets. Pour en savoir plus, consultez Macros Google Sheets.

Modules complémentaires pour Google Sheets

Les modules complémentaires sont des projets Apps Script empaquetés qui s'exécutent dans Google Sheets et peuvent être installés à partir du magasin de modules complémentaires Google Sheets. Si vous avez développé un script pour Google Sheets et que vous souhaitez le partager avec le monde entier, Apps Script vous permet de publier votre script en tant que module complémentaire afin que d'autres utilisateurs puissent l'installer à partir du magasin.

Triggers

Les scripts liés à un fichier Google Sheets peuvent utiliser des déclencheurs simples tels que les fonctions onOpen() et onEdit() pour répondre automatiquement lorsqu'un utilisateur disposant d'un accès en modification à la feuille de calcul ouvre ou modifie la feuille.

Comme les déclencheurs simples, les déclencheurs installables permettent à Google Sheets d'exécuter automatiquement une fonction lorsqu'un événement spécifique se produit. Les déclencheurs installables offrent cependant plus de flexibilité que les déclencheurs simples et sont compatibles avec les événements suivants: ouverture, modification, modification, envoi de formulaire et horloge (horaire).