Suivez cette procédure générale pour créer un module complémentaire Editor:
- Créez un projet Apps Script.
- Écrivez du code pour définir l'apparence et le comportement du module complémentaire à l'aide du service HTML intégré d'Apps Script.
- 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 du 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 racine Drive.
Collaboration
Lorsque vous collaborez avec d'autres personnes pour développer un module complémentaire, un seul compte utilisateur en est le propriétaire. Lorsque vous publiez un module complémentaire, un seul compte utilisateur agit en tant qu'éditeur. Le compte de publication doit disposer d'un accès en modification au projet de script du module complémentaire, mais il n'a pas besoin d'être le propriétaire du projet.
Il est très important d'éviter les situations où 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 du 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 de votre module complémentaire dans un Drive partagé, vous vous assurez qu'aucun compte n'est le seul propriétaire du projet.
Nous vous recommandons également d'ajouter des collaborateurs au projet Cloud Platform (GCP) du projet de script. Cela permet de s'assurer qu'un membre de votre équipe peut toujours accéder 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. Vous utilisez HtmlService dans Apps Script pour créer l'interface utilisateur du module complémentaire (boîtes de dialogue et barres latérales) à l'aide de HTML et CSS standards. Les modules complémentaires d'éditeur peuvent également définir des éléments de menu personnalisés.
Lorsque vous codez, consultez le guide de style des modules complémentaires de l'éditeur pour obtenir des conseils sur la conception de l'expérience utilisateur de votre module complémentaire. Veillez également à comprendre et à programmer les différents états du cycle de vie de l'autorisation 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 se comportent 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
La publication de votre module complémentaire le rend disponible pour d'autres utilisateurs, que ce soit publiquement ou uniquement pour les utilisateurs de votre domaine. Avant de commencer le processus de publication, consultez la présentation de la publication.
Les modules complémentaires pour l'éditeur sont publiés sur Google Workspace Marketplace. Les modules complémentaires disponibles publiquement doivent être examinés avant d'être publiés.
Pour en savoir plus, consultez Publier un module complémentaire d'éditeur.