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, ainsi que d'une ou plusieurs fiches.
Chaque carte représente une "page" spécifique de l'interface utilisateur de votre module complémentaire. Pour accéder à une nouvelle carte, il suffit généralement de la créer et de la transmettre dans une pile de cartes interne. Vous pouvez définir des flux de navigation entre les fiches 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 à l'ouverture d'un message Gmail ou d'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 intégrés à Apps Script utilisent le service de cartes pour créer des interfaces utilisateur à partir de fiches. Les modules complémentaires créés dans d'autres langages 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 de fiche. Chaque section est composée d'un ensemble de widgets. Les widgets présentent des informations à l'utilisateur ou fournissent des commandes d'interaction telles que des boutons.
Les interfaces à cartes présentent les avantages suivants:
- Aucune connaissance du langage HTML ou CSS n'est nécessaire pour créer des interfaces basées sur des fiches.
- Les fiches et les widgets sont automatiquement stylisés pour fonctionner correctement avec les applications Google Workspace qu'ils étendent.
Les interfaces basées sur des cartes fonctionnent à la fois sur les ordinateurs et sur les appareils mobiles, mais vous ne devez les définir 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 fiches, 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 événement
- Créer des cartes
- Créer des fiches interactives
- Parcourir 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
Reportez-vous à 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 "Chats"
Cet exemple de module complémentaire présente l'interface utilisateur simple d'un module complémentaire Google Workspace avec plusieurs pages et pages d'accueil.
Module complémentaire Google Workspace: "Traduire"
Cet exemple présente un module complémentaire Google Workspace permettant aux utilisateurs de traduire du texte à partir de Docs, Sheets et Slides.
Module complémentaire Google Workspace: "Liste des équipes"
Cet exemple de module complémentaire illustre un exemple plus complexe de modules complémentaires Google Workspace, qui affiche des informations utilisateur sur les destinataires des messages Gmail, les éditeurs de fichiers Drive ou les participants à des é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.