Les modules complémentaires sont soumis à certaines restrictions. Améliorez l'expérience globale de vos utilisateurs en évitant ces écueils.
Restrictions générales
Les restrictions suivantes s'appliquent à tous les modules complémentaires. Ne faites pas ce qui suit:
Modifier les fonctionnalités dans Google Workspace
Le framework de modules complémentaires est conçu pour améliorer les applications Google Workspace, et non pour ajouter des limites. Par conséquent, vous ne pouvez pas modifier les fonctionnalités existantes ni verrouiller le modèle de partage de documents Google Workspace.
Faire payer les utilisateurs pour l'installation
Nous ne fournissons aucun moyen de facturer aux utilisateurs l'installation de modules complémentaires, et les modules complémentaires ne peuvent pas inclure d'annonces. Toutefois, vous pouvez créer votre propre système de paiement ou appeler une base de données de facturation existante. Votre module complémentaire peut se connecter à des services autres que Google qui facturent les utilisateurs.
Détection de nombreux événements
À l'exception de certains déclencheurs, les modules complémentaires ne peuvent pas savoir ce qu'un utilisateur fait en dehors du module complémentaire lui-même. Par exemple, vous ne pouvez pas détecter quand l'utilisateur clique sur la barre d'outils de l'application hôte. Il est possible d'interroger les modifications du contenu d'un fichier à partir du code côté client d'une barre latérale, mais vous aurez toujours un léger retard.
Modules complémentaires Google Workspace
Les restrictions suivantes ne s'appliquent qu'aux modules complémentaires Google Workspace et à l'utilisation du service de cartes. Ne faites pas ce qui suit:
Étendre toutes les applications Google Workspace
Les modules complémentaires Google Workspace ne peuvent étendre que Gmail, Agenda, Drive, Docs, Sheets et Slides. À terme, les modules complémentaires Google Workspace pourront étendre d'autres applications Google Workspace.
Déclenchement contextuel dans Drive
Les modules complémentaires Google Workspace ne peuvent fournir de déclenchement contextuel que pour Gmail lorsque vous lisez ou rédigez des messages, et dans Agenda lorsque des événements sont ouverts. Le déclenchement contextuel pour les fichiers Drive n'est pas encore disponible. Consultez les pratiques de développement provisoire.
Contexte du document dans les éditeurs
Les modules complémentaires Google Workspace ne prennent pas encore en charge l'utilisation du contexte du document dans les éditeurs. Autrement dit, vous ne pouvez pas utiliser des méthodes telles que SpreadsheetApp.getActiveSpreadsheet() pour acquérir le document actuel. Consultez les pratiques de développement provisoire.
Utiliser du code HTML/CSS ou du script côté client
Les modules complémentaires Google Workspace doivent utiliser des interfaces basées sur des cartes. Les interfaces HTML/CSS compatibles avec les modules complémentaires Editor ne peuvent pas être utilisées. Les modules complémentaires Google Workspace utilisent une approche basée sur des widgets pour créer des interfaces utilisateur. Le module complémentaire fonctionne ainsi aussi bien sur les plates-formes pour ordinateur que sur celles pour mobile, sans que vous ayez à créer une interface pour chacune d'elles.
Compatibilité complète avec les mobiles
Pour le moment, les modules complémentaires Google Workspace fonctionnent sur les clients Web pour ordinateur. Le déclenchement contextuel (c'est-à-dire la lecture des messages Gmail) est également compatible avec l'application mobile Gmail. Les pages d'accueil non contextuelles ne sont pas encore disponibles dans les applications mobiles Gmail, Agenda ou Drive. Les modules complémentaires Google Workspace ne sont pas disponibles dans les navigateurs Web mobiles.
Utiliser des déclencheurs Apps Script
Vous ne pouvez pas créer ni utiliser de déclencheurs simples Apps Script dans un module complémentaire Google Workspace.
Utiliser des images SVG
Vous ne pouvez pas utiliser d'images SVG avec les fiches et les widgets du service de cartes.
Avoir plus de 100 widgets
Pour des raisons de performances, vous ne pouvez pas ajouter plus de 100 widgets ni 100 sections à une fiche.