Les modules complémentaires sont soumis à quelques restrictions. Évitez ces pièges pour améliorer l'expérience globale de vos utilisateurs.
Restrictions générales
Les restrictions suivantes s'appliquent à tous les modules complémentaires. Évitez les pratiques suivantes:
Modifier les fonctionnalités dans Google Workspace
Le framework des 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.
Facturer l'installation par les utilisateurs
Il n'est pas possible de facturer l'installation de modules complémentaires aux utilisateurs, et les modules complémentaires ne peuvent pas inclure d'annonces. Toutefois, vous pouvez déployer votre propre système de paiement ou effectuer un appel dans 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étecter de nombreux événements
À l'exception de certains déclencheurs, les modules complémentaires ne peuvent pas indiquer les actions d'un utilisateur en dehors du module 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. Vous pouvez interroger les modifications apportées au 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 s'appliquent uniquement aux modules complémentaires Google Workspace et à l'utilisation du service de cartes. Évitez les pratiques suivantes:
É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 déclencher des événements contextuels que pour Gmail lors de la lecture ou de la rédaction de 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 provisoires.
Documenter le contexte dans les éditeurs
Les modules complémentaires Google Workspace ne sont pas encore compatibles avec l'utilisation du contexte du document dans les éditeurs. Autrement dit, vous ne pouvez pas utiliser de méthodes telles que SpreadsheetApp.getActiveSpreadsheet() pour acquérir le document actuel. Consultez les pratiques de développement provisoires.
Utilisez le langage HTML/CSS ou un script côté client.
Les modules complémentaires Google Workspace doivent utiliser des interfaces basées sur des fiches. Les interfaces HTML/CSS compatibles avec les modules complémentaires des éditeurs 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. Cela permet au module complémentaire de fonctionner correctement sur les plates-formes de bureau et mobiles sans que vous ayez à créer une interface pour chacune d'elles.
Compatibilité complète avec les appareils mobiles
Pour l'instant, 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 depuis 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
Pour le moment, vous ne pouvez pas utiliser d'images SVG avec les cartes et les widgets de service de carte.
Inclure plus de 100 widgets
Pour des raisons de performances, vous ne pouvez pas ajouter plus de 100 widgets ou 100 sections de fiches à une fiche.