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 cartes.
Chaque fiche représente une "page" particulière de l'interface utilisateur de votre module complémentaire. Pour accéder à une nouvelle fiche, il suffit généralement de créer cette fiche et de la placer dans une pile de fiches interne. Vous pouvez définir des flux de navigation entre les cartes pour une expérience d'interaction enrichie.
Les cartes peuvent être non contextuelles ou contextuelles. Les cartes 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 (comme 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 son agenda.
Les modules complémentaires Google Workspace créés dans Apps Script utilisent le service Card 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 mis en forme pour que l'interface s'affiche sous forme de fiches.
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 mis en forme pour fonctionner correctement avec les applications Google Workspace qu'ils étendent.
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 fiches, il est important de comprendre certains concepts et modèles de conception. Les guides suivants vous fournissent les informations dont vous avez besoin pour créer des modules complémentaires efficaces basés sur des fiches :
- Fiches
- Pages d'accueil
- Widgets
- Actions
- Objets d'événement
- Créer des fiches
- Créer des fiches interactives
- Naviguer entre les fiches
- Utiliser les 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 non Google
- Guide de style
- Bonnes pratiques
Consultez ces pages lorsque vous créez des fiches et implémentez le comportement de l'UI. Les exemples supplémentaires suivants peuvent également vous être utiles pour l'implémentation de votre module complémentaire :
Démarrage rapide du module complémentaire Google Workspace "Chats"
Cet exemple de module complémentaire montre une interface utilisateur simple de module complémentaire Google Workspace 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 dans Docs, Sheets et Slides.
Module complémentaire Google Workspace : "Liste des équipes"
Cet exemple de module complémentaire montre 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 utilisateur.