Macros Google Sheets

Google Sheets vous permet d'enregistrer des macros qui dupliquent une série spécifique d'interactions de l'interface utilisateur que vous avez définie. Une fois que vous avez enregistré une macro, vous pouvez l'associer à un raccourci clavier sous la forme Ctrl+Alt+Shift+Number. Vous pouvez utiliser ce raccourci pour réexécuter rapidement les mêmes étapes de la macro, généralement à un autre endroit ou sur des données différentes. Vous pouvez également activer la macro depuis le menu Extensions > Macros de Google Sheets.

Lorsque vous enregistrez une macro, Google Sheets crée automatiquement une fonction Apps Script (la fonction macro) qui réplique les étapes de la macro. La fonction de macro est ajoutée à un projet Apps Script lié à la feuille, dans un fichier nommé macros.gs. Si un fichier de projet est déjà lié à la feuille portant ce nom, la fonction de macro y est ajoutée. Google Sheets met également à jour automatiquement le fichier manifeste du projet de script, en enregistrant le nom et le raccourci clavier attribué à la macro.

Chaque macro enregistrée étant entièrement définie dans Apps Script, vous pouvez les modifier directement dans l'éditeur Apps Script. Vous pouvez même écrire des macros à partir de zéro dans Apps Script ou utiliser des fonctions que vous avez déjà écrites pour les transformer en macros.

Créer des macros dans Apps Script

Vous pouvez prendre des fonctions écrites dans Apps Script et les utiliser en tant que fonctions macro. Pour ce faire, le moyen le plus simple consiste à importer une fonction existante à partir de l'éditeur Google Sheets.

Vous pouvez également créer des macros dans l'éditeur Apps Script en procédant comme suit:

  1. Dans l'interface utilisateur de Google Sheets, sélectionnez Extensions > Apps Script pour ouvrir le script lié à la feuille dans l'éditeur Apps Script.
  2. Écrivez la fonction macro. Les fonctions macro ne doivent accepter aucun argument et ne renvoyer aucune valeur.
  3. Modifiez le fichier manifeste de script pour créer la macro et l'associer à la fonction de macro. Attribuez-lui un raccourci clavier et un nom uniques.
  4. Enregistrez le projet de script. Vous pouvez ensuite utiliser la macro dans la feuille.
  5. Testez la fonction macro dans la feuille pour vérifier qu'elle fonctionne comme prévu.

Modification des macros

Pour modifier les macros associées à une feuille, procédez comme suit:

  1. Dans l'interface utilisateur Google Sheets, sélectionnez Extensions > Macros > Gérer les macros.
  2. Recherchez la macro que vous souhaitez modifier, puis sélectionnez > Modifier la macro. L'éditeur Apps Script ouvre le fichier de projet contenant la fonction de macro.
  3. Modifiez la fonction de macro pour changer le comportement de la macro.
  4. Enregistrez le projet de script. Vous pouvez ensuite utiliser la macro dans la feuille.
  5. Testez la fonction macro dans la feuille pour vérifier qu'elle fonctionne comme prévu.

Importer des fonctions en tant que macros

Si un script est déjà lié à une feuille, vous pouvez import une fonction dans le script en tant que nouvelle macro, puis lui attribuer un raccourci clavier. Pour ce faire, modifiez le fichier manifeste et ajoutez un autre élément à la propriété sheets.macros[].

Vous pouvez également suivre ces étapes pour importer une fonction en tant que macro à partir de l'interface utilisateur Sheets:

  1. Dans l'interface utilisateur Google Sheets, sélectionnez Extensions > Macros > Importer.
  2. Sélectionnez une fonction dans la liste présentée, puis cliquez sur Ajouter une fonction.
  3. Sélectionnez pour fermer la boîte de dialogue.
  4. Sélectionnez Extensions > Macros > Gérer les macros.
  5. Dans la liste, localisez la fonction que vous venez d'importer. Attribuez un raccourci clavier unique à la macro. Vous pouvez également modifier le nom de la macro ici. Le nom par défaut est celui de la fonction.
  6. Cliquez sur Mettre à jour pour enregistrer la configuration de la macro.

Structure du fichier manifeste pour les macros

L'exemple d'extrait de fichier manifeste suivant montre la section d'un fichier manifeste qui définit les macros Google Sheets. La section sheets du fichier manifeste définit le nom et le raccourci clavier attribués à la macro, ainsi que le nom de la fonction de macro.

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

Pour en savoir plus sur la structure des fichiers manifestes de macros Sheets, consultez la section Ressource de fichier manifeste de macros Sheets.

Bonnes pratiques

Lorsque vous créez ou gérez des macros dans Apps Script, nous vous recommandons de suivre les consignes suivantes.

  1. Les macros sont plus performantes lorsqu'elles sont légères. Si possible, limitez le nombre d'actions qu'une macro effectue.
  2. Les macros conviennent mieux aux opérations continues qui doivent être répétées fréquemment, avec peu ou pas de configuration. Pour les autres opérations, envisagez plutôt d'utiliser un élément de menu personnalisé.
  3. N'oubliez jamais que les raccourcis clavier des macros doivent être uniques et qu'une feuille donnée ne peut comporter que 10 macros avec raccourcis à la fois. Vous ne pouvez exécuter d'autres macros que depuis le menu Extensions > Macros.
  4. Les macros qui modifient une seule cellule peuvent être appliquées à une plage de cellules en sélectionnant d'abord la plage complète, puis en activant la macro. Cela signifie qu'il est souvent inutile de créer des macros qui dupliquent la même opération dans une plage de cellules prédéfinie.

Ce que vous ne pouvez pas faire

Les possibilités offertes par les macros sont limitées:

Utiliser des macros en dehors des scripts liés

Les macros sont définies dans des scripts liés à des feuilles de calcul Google Sheets spécifiques. Les définitions de macro sont ignorées si elles sont définies dans un script autonome ou une application Web.

Définir des macros dans les modules complémentaires Sheets

Vous ne pouvez pas distribuer des définitions de macro à l'aide d'un module complémentaire Sheets. Toutes les définitions de macro dans un projet de module complémentaire Sheets sont ignorées par les utilisateurs de ce module complémentaire.

Distribuer des macros dans des bibliothèques de scripts

Vous ne pouvez pas distribuer des définitions de macro à l'aide des bibliothèques Apps Script.

Utiliser des macros en dehors de Google Sheets

Les macros ne sont que des fonctionnalités de Google Sheets. Elles n'existent pas dans Google Docs, Forms ou Slides.