Lorsque vous créez un module complémentaire de l'éditeur, procédez comme suit:
- Créez un projet Apps Script.
- Rédigez du code pour définir l'apparence et le comportement du module complémentaire à l'aide du service HTML Apps Script intégré.
- Testez le module complémentaire.
- Publiez le module complémentaire.
Créer un projet de script
Un module complémentaire de l'éditeur est un projet Apps Script autonome. Le guide de script autonome fournit des instructions pour créer des projets.
Vous pouvez également simplement ouvrir un nouveau script.
Dans ce cas, le fichier de projet (initialement nommé Untitled project) est placé dans votre dossier Drive racine.
Collaboration
Lorsque vous collaborez avec d'autres personnes au développement d'un module complémentaire, un seul compte utilisateur est propriétaire du projet de module complémentaire. Lorsque vous publiez un module complémentaire, un seul compte utilisateur agit en tant qu'éditeur. Le compte de publication doit être autorisé à modifier le projet de script du module complémentaire, mais il n'a pas besoin d'être propriétaire du projet.
Il est très important d'éviter les situations dans lesquelles vous perdez l'accès au code ou aux paramètres d'un module complémentaire parce que le propriétaire du projet a quitté votre organisation.
Pour éviter de perdre l'accès au code d'un module complémentaire, nous vous encourageons à utiliser des Drive partagés lorsque vous collaborez sur un module complémentaire. En plaçant le fichier de script du module complémentaire dans un Drive partagé, vous vous assurez qu'aucun compte n'est le seul propriétaire du projet.
Il est également recommandé d'ajouter des collaborateurs au projet Cloud Platform (GCP) du projet de script. Cela permet de garantir qu'un membre de votre équipe a toujours accès aux paramètres cloud du module complémentaire.
Coder le module complémentaire
Une fois que vous avez créé un projet de script, vous pouvez commencer à écrire du code pour définir l'apparence et le comportement du module complémentaire. Avec Apps Script, HtmlService vous permet de créer l'interface utilisateur du module complémentaire (boîtes de dialogue et barres latérales) à l'aide du code HTML et CSS conventionnel. Les modules complémentaires de l'éditeur peuvent également définir des éléments de menu personnalisés.
Lorsque vous codez, reportez-vous au guide de style du module complémentaire Editor pour savoir comment concevoir l'expérience utilisateur de votre module complémentaire. Assurez-vous également de comprendre et de programmer les différents états du cycle de vie des autorisations que votre module complémentaire peut rencontrer.
Tester le module complémentaire
Vous pouvez tester les modules complémentaires de l'éditeur avant leur publication pour vous assurer qu'ils fonctionnent comme prévu. Pour effectuer des tests, vous devez créer une configuration de test et utiliser un document, une feuille de calcul, un formulaire ou une présentation de test.
Pour en savoir plus, consultez Tester un module complémentaire d'éditeur.
Publier le module complémentaire
En publiant votre module complémentaire, vous le rendez disponible pour les autres utilisateurs, publiquement ou uniquement pour les utilisateurs de votre domaine. Avant de commencer le processus de publication, veillez à consulter la présentation de la publication.
Les modules complémentaires des éditeurs sont publiés sur Google Workspace Marketplace. Les modules complémentaires accessibles au public doivent être examinés avant d'être publiés.
Pour en savoir plus, consultez la page Publier un module complémentaire d'éditeur.