Cette page a été traduite par l'API Cloud Translation.

Macros Google Sheets

Google Sheets vous permet d'enregistrer des macros qui dupliquent une série spécifique d'interactions d'interface utilisateur que vous définissez. Une fois que vous avez enregistré une macro, vous pouvez l'associer à un raccourci clavier au format Ctrl+Alt+Shift+Number. Vous pouvez utiliser ce raccourci pour réexécuter rapidement les étapes exactes de la macro, généralement dans un autre emplacement ou sur d'autres données. Vous pouvez également activer la macro dans le menu Google Sheets Extensions > Macros.

Lorsque vous enregistrez une macro, Google Sheets crée automatiquement une fonction Apps Script (la fonction macro) qui reproduit les étapes de la macro. La fonction de macro est ajoutée à un projet Apps Script lié à la feuille, dans un fichier intitulé macros.gs. S'il existe déjà un fichier de projet associé à la feuille avec ce nom, la fonction de macro y est ajoutée. Google Sheets met également automatiquement à jour le manifest du projet de script, en enregistrant le nom et le raccourci clavier attribués à la macro.

Étant donné que chaque macro enregistrée est 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 transformer des fonctions que vous avez déjà écrites en macros.

Créer des macros dans Apps Script

Vous pouvez utiliser des fonctions écrites en Apps Script comme fonctions de macro. Le moyen le plus simple de procéder consiste à importer une fonction existante depuis l'éditeur Google Sheets.

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

Dans l'interface utilisateur de Google Sheets, sélectionnez Extensions > Apps Script pour ouvrir le script associé à la feuille dans l'éditeur Apps Script.
Écrivez la fonction de macro. Les fonctions de macro ne doivent pas comporter d'arguments et ne doivent pas renvoyer de valeurs.
Modifiez votre fichier manifeste de script pour créer la macro et l'associer à la fonction de macro. Attribuez-lui un nom et un raccourci clavier uniques.
Enregistrez le projet de script. La macro est alors disponible dans la feuille.
Testez la fonction de macro dans la feuille pour vous assurer qu'elle fonctionne comme prévu.

Modifier des macros

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

Dans l'interface utilisateur de Google Sheets, sélectionnez Extensions > Macros > Gérer les macros.
Recherchez la macro que vous souhaitez modifier, puis sélectionnez > Modifier la macro. L'éditeur Apps Script s'ouvre sur le fichier de projet contenant la fonction de macro.
Modifiez la fonction de la macro pour modifier son comportement.
Enregistrez le projet de script. La macro est alors disponible dans la feuille.
Testez la fonction de macro dans la feuille pour vous assurer qu'elle fonctionne comme prévu.

Importer des fonctions en tant que macros

Si un script est déjà associé à 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 procéder comme suit pour importer une fonction en tant que macro depuis l'interface utilisateur de Sheets:

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

Structure du fichier manifeste pour les macros

L'extrait d'exemple de fichier manifeste suivant montre la section d'un manifest 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 création des fichiers manifestes de macro Sheets, consultez la ressource sur les fichiers manifestes de macro Sheets.

Bonnes pratiques

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

Les macros sont plus performantes lorsqu'elles sont légères. Si possible, limitez le nombre d'actions d'une macro.
Les macros sont particulièrement adaptées aux opérations répétitives qui doivent être répétées fréquemment avec peu ou pas de configuration. Pour les autres opérations, envisagez d'utiliser un élément de menu personnalisé à la place.
N'oubliez pas que les raccourcis de clavier de macro doivent être uniques et qu'une feuille donnée ne peut contenir que dix macros avec des raccourcis à la fois. Les macros supplémentaires ne peuvent être exécutées que depuis le menu Extensions > Macros.
Les macros qui apportent des modifications à 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. Par conséquent, il est souvent inutile de créer des macros qui dupliquent la même opération sur une plage de cellules prédéfinie.

Ce que vous ne pouvez pas faire

Les macros sont soumises à certaines restrictions:

Utiliser des macros en dehors des scripts liés

Les macros sont définies dans des scripts associé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 de définitions de macro à l'aide d'un module complémentaire Sheets. Les définitions de macro d'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 de définitions de macro à l'aide de bibliothèques Apps Script.

Utiliser des macros en dehors de Google Sheets

Les macros ne sont disponibles que dans Google Sheets. Elles n'existent pas dans Google Docs, Google Forms ni Google Slides.