Google Sheets est une solution de feuille de calcul basée dans le cloud qui permet de collaborer en temps réel et qui offre des outils puissants pour visualiser, traiter et communiquer des données.
Vous pouvez étendre Sheets avec des modules complémentaires qui améliorent vos workflows de manière personnalisée, établissent une connectivité avec des systèmes tiers et intègrent vos données Sheets à d'autres applications Google Workspace (comme Google Slides).
Vous pouvez consulter les modules complémentaires Sheets créés par d'autres utilisateurs sur le Google Workspace Marketplace.
Ce que vous pouvez faire
Voici quelques exemples de ce que vous pouvez faire avec un module complémentaire qui étend Google Sheets :
- Vous pouvez lire, modifier, visualiser et mettre en forme des données dans des feuilles de calcul Google Sheets à l'aide du service de feuille de calcul Apps Script intégré. Le service vous permet également de créer et de modifier des règles de mise en forme conditionnelle et de validation des données.
- Vous pouvez utiliser le service Sheets avancé Apps Script pour accéder directement à l'API Google Sheets.
- Vous pouvez créer des menus personnalisés et définir plusieurs interfaces de boîtes de dialogue et barres latérales personnalisées à l'aide du code HTML et CSS standards.
- Vous pouvez inclure des définitions de fonctions personnalisées dans votre module complémentaire.
- Vous pouvez utiliser des déclencheurs de modules complémentaires qui exécutent des fonctions spécifiées lorsque certains événements déclencheurs se produisent.
Les modules complémentaires Sheets sont créés à l'aide d'Apps Script. Pour savoir comment accéder à Google Sheets et le gérer avec Apps Script, consultez Étendre Google Sheets.
Structure de la feuille
Une feuille de calcul Google Sheets est composée d'une ou de plusieurs feuilles. Chaque feuille est essentiellement une grille 2D de cellules dans lesquelles du texte, des nombres, des liens ou d'autres valeurs peuvent être stockés. Un groupe d'une ou plusieurs cellules adjacentes est appelé plage.
Le service Spreadsheet d'Apps Script fournit plusieurs classes pour représenter les structures organisationnelles dans Sheets (telles que Sheet et Range). Vous pouvez utiliser ces classes pour lire et modifier les données et le comportement de Sheets.
Déclencheurs
Les déclencheurs Apps Script permettent à un projet de script d'exécuter une fonction spécifiée lorsque certaines conditions sont remplies, par exemple lorsqu'une feuille de calcul est ouverte ou lorsqu'un module complémentaire est installé.
Pour en savoir plus sur les déclencheurs pouvant être utilisés avec les modules complémentaires Sheets et sur les restrictions qui s'appliquent à leur utilisation, consultez Déclencheurs de modules complémentaires.
Fonctions personnalisées
Google Sheets propose un certain nombre de fonctions intégrées, comme SUM et AVERAGE, qui peuvent être appelées à partir d'une cellule Google Sheets.
Les modules complémentaires Sheets peuvent définir des fonctions personnalisées supplémentaires pour compléter ces fonctions intégrées. Lorsqu'un utilisateur installe le module complémentaire, toutes les fonctions personnalisées définies incluses dans le module complémentaire deviennent immédiatement disponibles. Il est possible qu'un module complémentaire ne contienne que des définitions de fonctions personnalisées. Les définitions de fonctions personnalisées sont principalement partagées avec d'autres utilisateurs en publiant un module complémentaire contenant les définitions.
Créer des fonctions personnalisées pour les modules complémentaires
Toute fonction définie dans un projet de script de module complémentaire peut être utilisée comme fonction personnalisée. Une fois la fonction implémentée et le module complémentaire installé, vous pouvez appeler la fonction personnalisée comme n'importe quelle autre fonction Sheets intégrée : dans une cellule de feuille de calcul, saisissez =, suivi du nom de la fonction et des paramètres requis. En l'absence d'erreurs, le résultat renvoyé par la fonction est placé dans la cellule de la feuille, en débordant sur les cellules voisines si nécessaire.
Lorsque vous créez des fonctions personnalisées dans un module complémentaire, vous devez suivre les consignes générales relatives aux fonctions personnalisées :
- Consignes pour nommer les fonctions
- Définir les arguments de fonction
- Définir la valeur renvoyée par la fonction
- Types de données des fonctions personnalisées
- Activer la saisie semi-automatique à l'aide de JSDoc
- Services pouvant utiliser des fonctions personnalisées
- Optimiser les fonctions personnalisées
De plus, les fonctions personnalisées définies dans les modules complémentaires doivent tenir compte de certains points spécifiques :
- Lorsque vous nommez votre fonction, essayez de créer un nom unique, peut-être lié au nom de votre module complémentaire. Si deux modules complémentaires installés ou plus définissent des fonctions personnalisées portant le même nom, les utilisateurs ne peuvent en utiliser qu'une seule.
- Votre module complémentaire doit indiquer clairement les fonctions personnalisées qu'il fournit. Veillez à fournir des commentaires JSDoc précis pour vos fonctions personnalisées afin qu'Apps Script puisse présenter des informations d'autocomplétion à l'utilisateur. En outre, pensez à fournir une documentation supplémentaire sur les fonctions personnalisées, soit dans le module complémentaire lui-même, soit sur une page Web d'assistance pour les modules complémentaires.
- Les fonctions personnalisées qui ne se terminent pas en moins de 30 secondes échouent et renvoient une erreur
Internal error executing the custom function. Offrez une expérience utilisateur de qualité en limitant la quantité de traitement effectuée dans une fonction personnalisée. Optimisez la fonction dans la mesure du possible. - Les fonctions personnalisées ne peuvent pas utiliser les services Apps Script qui nécessitent une autorisation. Si elles tentent de le faire, elles échouent et génèrent une erreur
You do not have permission to call X service. N'utilisez que les services autorisés dans votre fonction personnalisée. - Chaque fonction personnalisée d'une feuille génère un appel distinct aux serveurs Apps Script. Si un utilisateur tente d'utiliser des fonctions personnalisées dans un trop grand nombre de cellules, les fonctions peuvent s'exécuter lentement. Pour éviter cela, veillez à ce que vos fonctions personnalisées soient aussi simples que possible. Si vous avez besoin que la fonction effectue un traitement complexe ou étendu, n'utilisez pas de fonction personnalisée. Fournissez plutôt cette fonctionnalité via un élément de menu, une boîte de dialogue ou une interaction de barre latérale.
Macros Sheets
Les macros vous permettent d'enregistrer des actions effectuées dans Google Sheets et de les répéter ultérieurement à l'aide d'un raccourci clavier. Lorsqu'une macro est créée dans une feuille, elle est ajoutée en tant que fonction de macro dans un projet Apps Script lié à cette feuille. Pour en savoir plus sur les macros, consultez Macros Google Sheets.
Malheureusement, les macros Sheets ne peuvent pas être distribuées avec les modules complémentaires. Si vous incluez une définition de macro dans le fichier manifeste d'un module complémentaire, elle n'est pas disponible pour les utilisateurs de ce module.