Avant de créer votre module complémentaire Editor, consultez les quotas et limites d'Apps Script pour vous assurer que la conception de votre projet est conforme à ces consignes. En vous familiarisant avec ces limites dès le début de votre processus de développement, vous pouvez éviter les problèmes potentiels par la suite. Apps Script est idéal pour développer des modules complémentaires légers pour vous-même, votre équipe ou votre organisation. Toutefois, si vous prévoyez de créer un module complémentaire à grande échelle qui doit gérer de nombreux utilisateurs, nécessite une faible latence ou exige un contrôle total de votre infrastructure, envisagez de développer un module complémentaire Google Workspace dans un environnement d'exécution différent.
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 d'add-on, 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 pour les 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 de les publier 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, veillez à consulter 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.