Les modules complémentaires Google Workspace présentent des informations dans la barre latérale application hôte UI. Un module complémentaire comprend une barre d'outils d'identification principale ainsi qu'une ou plusieurs fiches.
Chaque fiche représente une "page" particulière de l'interface utilisateur de votre module complémentaire. accéder à une nouvelle carte consiste à créer cette carte et en le transférant sur une pile de cartes interne. Vous pouvez définir des flux de navigation entre les fiches pour offrir une expérience d'interaction enrichie.
Les fiches peuvent être contextuelles ou contextuelles. Des 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 d'agenda. Les fiches non contextuelles (comme 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 consulter sa boîte de réception Gmail, son dossier Drive principal ou son agenda.
Les modules complémentaires Google Workspace intégrés dans Apps Script utilisent Service de cartes pour créer des interfaces utilisateur à partir de fiches. Modules complémentaires disponibles dans d'autres langues doit 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 fiches. Chaque section est Il se compose d'un ensemble de widgets. Widgets afficher des informations à l'utilisateur ou fournir des commandes d'interaction comme des boutons.
Les interfaces basées sur des cartes présentent les avantages suivants:
- Aucune connaissance en HTML ou CSS n'est nécessaire pour créer des interfaces basées sur des fiches.
- Le style des fiches et des widgets est automatiquement appliqué aux éléments applications Google Workspace qu'ils étendent.
Les interfaces basées sur des cartes fonctionnent à la fois sur les ordinateurs de bureau et sur les appareils mobiles, mais vous vous devez définir l'interface 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 concepts et modèles de conception. Les guides suivants fournissent des informations vous devez 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 cartes
- Créer des fiches interactives
- Naviguer entre les cartes
- 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 Comportement de l'interface utilisateur Les exemples supplémentaires suivants peuvent également vous être utiles pour lorsque vous implémentez votre module complémentaire:
Module complémentaire Google Workspace "Chats" guide de démarrage rapide
Cet exemple de module complémentaire montre une UI 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 depuis dans Docs, Sheets et Slides.
Module complémentaire Google Workspace : "Liste des équipes"
Cet exemple de module complémentaire Exemple de module complémentaire Google Workspace : des informations utilisateur sur les destinataires des messages Gmail, les éditeurs de fichiers Drive ou Participants à un événement d'agenda Vous ne pouvez utiliser ce module complémentaire qu'à l'intérieur d'un domaine, car il utilise l'API Directory pour récupérer des informations sur l'utilisateur.