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. Vous familiariser avec ces limites dès le début de votre processus de développement peut vous aider à éviter des 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 sur un environnement d'exécution différent.
Suivez cette procédure générale lorsque vous créez 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 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 des scripts autonomes fournit des instructions pour créer des projets.
Vous pouvez aussi simplement ouvrir un nouveau script.
Si vous le faites, le fichier de projet (initialement nommé Untitled project) est placé dans le dossier racine de votre Drive.
Collaboration
Lorsque vous collaborez avec d'autres personnes pour développer 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 fait office d'é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 unique 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 le HtmlService Apps Script pour 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 d'éditeur peuvent également définir des éléments de menu personnalisés.
Lorsque vous codez, reportez-vous au guide de style des modules complémentaires de l'éditeur pour obtenir des consignes sur la conception de 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 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, 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 de l'éditeur sont publiés sur Google Workspace Marketplace. Les modules complémentaires disponibles publiquement doivent faire l'objet d'un examen avant d'être publiés.
Pour en savoir plus, consultez Publier un module complémentaire d'éditeur.