Améliorez l'expérience globale de vos utilisateurs en suivant ces guides de conception de modules complémentaires Google Meet.
Bonnes pratiques en matière d'autorisation
Nous vous encourageons à suivre les bonnes pratiques suivantes pour tous les modules complémentaires Google Meet qui nécessitent une authentification ou une autorisation.
Utiliser Google Sign-In
De nombreux utilisateurs des modules complémentaires Google Workspace se sont déjà connectés à Google avant de rejoindre la réunion. Par conséquent, proposer Google One Tap comme option peut faire gagner plusieurs clics à vos utilisateurs lors du processus de connexion. Pour en savoir plus, consultez Gérer les méthodes de connexion de votre module complémentaire.
Ouvrir la page de connexion tierce dans une nouvelle fenêtre
En plus de la connexion Google, votre application peut proposer des mécanismes de connexion supplémentaires. Si c'est le cas, utilisez une boîte de dialogue au lieu d'ouvrir une page de connexion dans un nouvel onglet. L'utilisateur peut ainsi toujours voir et revenir à l'appel Meet, et effectuer moins de clics au total.
Demander correctement des champs d'application pour les API Google
Si votre module complémentaire Meet appelle des API Google, vous devez fournir une liste complète des champs d'application OAuth requis par votre module complémentaire. Pour ce faire, accédez à la page "Configuration d'applications Google Workspace Marketplace". Une fois ces champs d'application ajoutés, une invite s'affiche lorsque vos utilisateurs installent votre module complémentaire Meet. Elle indique aux utilisateurs à quel type de données votre application a accès.
Avant de publier votre module complémentaire, vous devez également configurer l'écran de consentement OAuth. Pour ce faire, vous devez ajouter exactement les mêmes champs d'autorisation à partir de la configuration de votre application Google Workspace Marketplace. La configuration de l'écran d'autorisation OAuth nécessite également de définir les informations sur la marque, les règles de confidentialité et les conditions d'utilisation qui s'affichent lorsque des champs d'application sont demandés. Pour publier des informations publiquement, vous devez les envoyer pour validation.
Lorsque vous écrivez du code pour appeler les API Google Workspace, le moyen le plus simple de commencer est de suivre la démarrage rapide JavaScript. Cette approche respecte les bonnes pratiques d'utilisation de la connexion Google et des boîtes de dialogue. Notez que l'initialisation du client de jeton en JavaScript nécessite de demander séparément les portées que l'application utilise réellement au moment de l'exécution. Pour une expérience utilisateur optimale, ces champs d'application demandés doivent correspondre à ceux de la page de configuration de l'application Google Workspace Marketplace. Cette redondance fournit un plan de secours pour gérer le cas où un utilisateur a révoqué des champs d'application.
Bonnes pratiques de maintenance
Les bonnes pratiques suivantes sont destinées à l'écriture d'applications Web évolutives, mais elles sont particulièrement importantes lors de l'écriture de modules complémentaires Meet.
Utiliser la dernière version du SDK des modules complémentaires Google Meet
Le SDK des modules complémentaires Meet est régulièrement mis à jour. Le SDK respecte la gestion sémantique de version. Pour trouver la dernière version:
- Lorsque vous utilisez gstatic: la dernière version du SDK est contenue dans l'URL gstatic figurant dans les instructions d'utilisation du SDK.
- Lorsque vous utilisez npm: exécutez
npm update @googleworkspace/meet-add-onsà partir du répertoire contenant lepackage.jsonpour le site Web qui héberge votre module complémentaire Meet.
Créer un projet Google Cloud de préproduction
Une fois votre module complémentaire Google Meet publié sur Google Workspace Marketplace, tous les nouveaux déploiements de votre module complémentaire Google Meet sont immédiatement disponibles pour les utilisateurs de Meet. Les utilisateurs verront ces mises à jour dès qu'ils videront leurs caches ou que le cache expirera. C'est pourquoi nous vous recommandons de ne pas déployer les modifications sur votre site de production tant qu'elles n'ont pas été testées de manière approfondie.
Pour éviter de déployer directement en production, nous vous recommandons de créer un projet Google Cloud distinct publié en privé pour votre organisation. Ce projet Cloud hébergera à la fois les environnements de préproduction et de développement de votre module complémentaire Meet. L'accès à ce projet Cloud doit être limité à une petite équipe qui travaille directement sur le développement de votre module complémentaire.
Pour créer ces environnements alternatifs pour votre module complémentaire, vous devez d'abord héberger des environnements alternatifs de votre application Web contenant votre module complémentaire sur un domaine qui vous appartient. Vous pouvez ensuite créer d'autres environnements pour votre module complémentaire Meet en ajoutant des déploiements supplémentaires à votre projet Google Cloud de préproduction. Ces nouveaux déploiements doivent comporter des fichiers manifestes qui pointent vers les environnements alternatifs de votre application Web. Ensuite, nous vous recommandons d'installer chaque environnement de module complémentaire comme suit:
- Préproduction: publiez la version de préproduction en privé afin que tous les membres de votre organisation puissent vous aider à effectuer les tests.
- Développement: cliquez sur Installer dans la colonne Actions pour installer la version de développement du module complémentaire Meet uniquement sur votre compte.
Écrire des tests
Avant de déployer votre module complémentaire Meet dans un environnement de développement, nous vous recommandons d'écrire des tests unitaires. Vos tests unitaires doivent inclure:
- Simuler le SDK des modules complémentaires Meet, puis vérifier que le module complémentaire Meet appelle les fonctions du SDK comme prévu.
- Effectuez des tests unitaires de toutes les fonctionnalités non liées au SDK de votre module complémentaire avec le framework de test Web de votre choix.
Bonnes pratiques concernant l'expérience utilisateur
Les bonnes pratiques suivantes vous aideront à rendre un module complémentaire Meet plus intuitif et plus raffiné.
Gérer tous les états de démarrage dans le panneau latéral
Nous vous recommandons vivement de configurer votre module complémentaire en fonction des actions des utilisateurs dans le panneau latéral.
Pour ce faire, définissez l'état de démarrage de l'activité en JavaScript. Toutes les données qui sont transmises à ActivityStartingState doivent être définies par l'initiateur du module complémentaire (généralement l'hôte de la réunion) dans le panneau latéral. Vous pouvez considérer la première vue du panneau latéral comme un formulaire qui contrôle la configuration de votre module complémentaire.
Fermer le panneau latéral lorsqu'il n'est pas utilisé
Après avoir démarré l'activité en appelant la méthode startActivity(), vous ne devez laisser le panneau latéral ouvert que s'il constitue une partie essentielle de l'expérience utilisateur de votre module complémentaire Google Meet. Vous pouvez fermer le panneau latéral une fois la plate-forme principale ouverte en appelant la méthode unloadSidePanel().
Promouvoir votre module complémentaire Meet via le partage d'écran
Les modules complémentaires Meet offrent une expérience plus riche que le partage d'écran. Cependant, de nombreux utilisateurs sont habitués à utiliser la fonctionnalité de partage d'écran de Meet. Si un utilisateur partage un onglet affichant le site Web qui héberge votre module complémentaire Meet, Meet peut être configuré pour afficher une bannière à tous les participants à l'appel les invitant à installer ou à utiliser le module complémentaire Meet correspondant. Pour en savoir plus, consultez la section Promouvoir votre module complémentaire via le partage d'écran.
Consignes de conception des logos
Suivez ces consignes lorsque vous concevez votre logo spécifique à Meet pour qu'il soit à son meilleur niveau maintenant et à l'avenir:
Utilisez le format de fichier PNG, avec une taille de 256 x 256 px.
Utilisez la transparence.
Vérifiez que votre logo en mode sombre s'affiche correctement en mode sombre à l'aide des outils pour les développeurs des modules complémentaires Meet.
Respectez les exigences graphiques pour les intégrations d'applications spécifiques.
N'incluez pas de marge intérieure dans votre image. Étendez plutôt l'image jusqu'aux limites de votre fichier.