Google Sheets est un service de feuilles de calcul qui offre une collaboration en temps réel et des outils puissants pour visualiser, traiter et communiquer des données.
Vous pouvez étendre Sheets à l'aide de modules complémentaires qui permettent d'améliorer le workflow personnalisé, Établir la connectivité avec des systèmes tiers et intégrer vos données Sheets avec d'autres applications Google Workspace (comme Google Slides).
Vous pouvez voir les modules complémentaires Sheets développés par d'autres utilisateurs à partir de la Google Workspace Marketplace.
Ce que vous pouvez faire
Voici quelques actions que vous pouvez effectuer avec un module complémentaire qui étend Google Sheets:
- Vous pouvez lire, modifier, visualiser et mettre en forme les données des feuilles de calcul Google Sheets à l'aide de la bibliothèque Apps Script intégrée Service Spreadsheet : Ce service vous permet également de créer et de modifier des données et une mise en forme conditionnelle règles de validation.
- Vous pouvez utiliser le service Sheets avancé d'Apps Script. pour accéder directement à l'API Google Sheets.
- Vous pouvez créer des menus personnalisés et définir plusieurs boîtes de dialogue et barres latérales personnalisées ; à l'aide des langages HTML et CSS standards.
- Vous pouvez inclure des définitions de fonctions personnalisées dans votre fichier un 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 en savoir plus sur la façon d’accéder et gérer Google Sheets avec Apps Script, consultez Développer Google Sheets
Structure de la feuille
Une feuille de calcul Google Sheets se compose d'une ou de plusieurs feuilles. Chaque feuille est Il s'agit d'une grille 2D de cellules contenant du texte, des nombres, des liens ou d'autres peuvent être stockées. Un groupe d'une ou de plusieurs cellules adjacentes est appelé plage.
Service Spreadsheet Apps Script
propose plusieurs classes pour représenter les structures organisationnelles dans Sheets
(par exemple, Sheet et
Range). Vous pouvez utiliser ces
pour lire et modifier les données et le comportement Sheets.
Déclencheurs
Les déclencheurs Apps Script permettent à un projet de créer un script exécuter une fonction spécifiée lorsque certaines conditions sont remplies, par exemple feuille de calcul est ouverte ou lorsqu'un module complémentaire est installé.
Pour en savoir plus, consultez la section Déclencheurs de modules complémentaires. sur les déclencheurs pouvant être utilisés avec les modules complémentaires Sheets et sur les restrictions applicables à leur utilisation.
Fonctions personnalisées
Google Sheets propose un certain nombre
fonctions intégrées
comme SUM et AVERAGE, qui peuvent être appelés à partir d'une cellule Google Sheets.
Les modules complémentaires Sheets peuvent définir
fonctions personnalisées en complément
fonctions intégrées. Lorsqu'un utilisateur
installe le module complémentaire, ainsi que toutes les fonctions personnalisées définies incluses dans ce module ;
sont disponibles immédiatement. Un module complémentaire peut être constitué de
que des définitions de fonctions personnalisées. Les définitions de fonctions personnalisées
sont principalement
partagés avec d'autres utilisateurs en publiant un module complémentaire contenant les définitions.
Créer des fonctions personnalisées de modules complémentaires
Toute fonction définie dans un projet de script complémentaire peut être utilisée en tant que
. Une fois la fonction implémentée et le module complémentaire installé,
pouvez appeler la fonction personnalisée comme n'importe quelle autre fonction Sheets intégrée: dans une
Cellule de feuille, saisissez = suivi du nom de la fonction et de toute valeur
paramètres. En l'absence d'erreurs, le résultat renvoyé par la fonction est
placée dans la cellule Feuille, déborde sur les cellules voisines si nécessaire.
Lorsque vous créez des fonctions personnalisées dans un module complémentaire, suivez les instructions ci-dessous : les consignes générales relatives aux fonctions personnalisées:
- Consignes relatives aux noms des fonctions
- Définir des arguments de fonction
- Définir la valeur renvoyée par la fonction
- Types de données de la fonction personnalisée
- Activer la saisie semi-automatique à l'aide de JSDoc
- Les fonctions personnalisées des services
- Optimiser les fonctions personnalisées
De plus, les fonctions personnalisées définies dans les modules complémentaires ont des attributs considérations à prendre en compte:
- Lorsque vous nommez votre fonction, essayez de créer un nom unique, éventuellement lié à le nom de votre module complémentaire. Si deux modules complémentaires ou plus installés définissent des fonctions portant le même nom, les utilisateurs ne peuvent utiliser qu'une seule d'entre elles.
- Votre module complémentaire doit indiquer clairement les fonctions personnalisées qu'il propose. Assurez-vous de fournir des commentaires JSDoc précis pour vos fonctions personnalisées afin que Apps Script peut présenter informations de la saisie semi-automatique pour l'utilisateur. En outre, pensez à fournir des documents supplémentaires sur des fonctions personnalisées dans le module complémentaire lui-même ou sur une page Web d'assistance de module complémentaire.
- Les fonctions personnalisées qui ne s'exécutent pas en moins de 30 secondes échouent avec une
Internal error executing the custom functionerreur. Fidéliser les utilisateurs en limitant la quantité de traitement que vous effectuez dans une fonction personnalisée. Optimiser la fonction là où vous le pouvez. - Les fonctions personnalisées ne peuvent pas utiliser les services Apps Script nécessitant une autorisation,
et échouent avec une erreur
You do not have permission to call X servicesi cette est tentée. Utilisez uniquement les services autorisés dans votre fonction personnalisée. - Chaque fonction personnalisée d'une feuille génère un appel distinct vers le script Apps Script. serveurs. Si un utilisateur tente d'utiliser des fonctions personnalisées dans un trop grand nombre de cellules, la fonctions peuvent s’exécuter lentement. Pour limiter ce problème, conservez vos fonctions personnalisées aussi simple que possible. Si vous avez besoin que la fonction exécute des tâches complexes ou étendues de traitement, n'utilisez pas de fonction personnalisée, fournissez cette fonctionnalité via un élément de menu, une boîte de dialogue ou une interaction de la barre latérale.
Macros Sheets
Les macros vous permettent d'enregistrer des actions. prises dans Google Sheets et les répéter plus tard à l'aide d'un raccourci clavier. Lorsqu'un est créée dans une feuille, elle est ajoutée en tant que fonction de macro dans une Projet de script lié à cette feuille. Pour plus sur les macros, consultez Macros Google Sheets :
Malheureusement, les macros Sheets ne peuvent pas être distribuées avec des modules complémentaires. Si vous incluez une définition de macro dans le fichier manifeste d'un module complémentaire, celle-ci n'est pas disponible pour les utilisateurs un module complémentaire.