Les modules complémentaires Google Workspace présentent des informations et des commandes utilisateur dans la barre latérale de l'interface utilisateur de l'application hôte. Un module complémentaire se compose d'une barre d'outils d'identification principale et d'une ou plusieurs fiches.
Chaque fiche représente une "page" particulière de l'interface utilisateur de votre module complémentaire. Pour accéder à une nouvelle fiche, il vous suffit généralement de la créer et de l'ajouter à une pile de cartes interne. Vous pouvez définir des flux de navigation entre les cartes pour une expérience d'interaction enrichie.
Les fiches peuvent être non contextuelles ou contextuelles. Les fiches contextuelles sont présentées à l'utilisateur lorsque l'application hôte se trouve dans un contexte spécifique. Par exemple, lorsque vous ouvrez un message Gmail ou un événement Agenda. Les fiches non contextuelles (telles que les pages d'accueil) sont présentées à l'utilisateur en dehors d'un contexte spécifique de l'hôte. (par exemple, lorsque l'utilisateur consulte sa boîte de réception Gmail, son dossier Drive principal ou Agenda) ;
Les modules complémentaires Google Workspace créés dans Apps Script utilisent le service de cartes pour créer des interfaces utilisateur à partir de cartes. Les modules complémentaires créés dans d'autres langues doivent renvoyer un fichier JSON correctement formaté pour que l'interface s'affiche sous forme de cartes.
Chaque fiche se compose d'un en-tête et d'une ou plusieurs sections. Chaque section est composée d'un ensemble de widgets. Les widgets affichent des informations à l'utilisateur ou fournissent des commandes d'interaction telles que des boutons.
Les interfaces basées sur des cartes présentent les avantages suivants:
- Aucune connaissance en HTML ou CSS n'est requise pour créer des interfaces basées sur des cartes.
- Les cartes et les widgets sont automatiquement stylisés pour fonctionner correctement avec les applications Google Workspace qu'ils complètent.
Les interfaces basées sur des fiches fonctionnent à la fois sur les ordinateurs et les appareils mobiles, mais vous n'avez besoin de définir l'interface qu'une seule fois.
Créer des interfaces basées sur des cartes
Lorsque vous créez des modules complémentaires basés sur des cartes, il est important de comprendre certains concepts et modèles de conception. Les guides suivants fournissent les informations dont vous avez besoin pour créer des modules complémentaires efficaces basés sur des cartes:
- Fiches
- Pages d'accueil
- Widgets
- Actions
- Objets d'événement
- Créer des fiches
- Créer des fiches interactives
- Naviguer entre les fiches
- Utiliser des actions universelles
- Ajouter la saisie semi-automatique aux entrées de texte
- Accéder aux paramètres régionaux et aux fuseaux horaires des utilisateurs
- Se connecter à des services autres que Google
- Guide de style
- Bonnes pratiques
Consultez ces pages lorsque vous créez des fiches et implémentez le comportement de l'interface utilisateur. Les exemples supplémentaires suivants peuvent également vous être utiles lorsque vous implémentez votre module complémentaire:
Guide de démarrage rapide du module complémentaire Google Workspace "Cats"
Cet exemple de module complémentaire présente une interface utilisateur de module complémentaire Google Workspace simple avec plusieurs pages et pages d'accueil.
Module complémentaire Google Workspace: "Traduire"
Cet exemple de module complémentaire montre un module complémentaire Google Workspace qui permet aux utilisateurs de traduire du texte depuis Docs, Sheets et Slides.
Module complémentaire Google Workspace: "Liste des équipes"
Cet exemple de module complémentaire présente un exemple de module complémentaire Google Workspace plus complexe, qui affiche des informations sur les destinataires des messages Gmail, les éditeurs de fichiers Drive ou les participants aux événements Agenda. Vous ne pouvez utiliser ce module complémentaire que dans un domaine, car il utilise l'API Directory pour récupérer les informations sur l'utilisateur.