Améliorez l'expérience globale de vos utilisateurs en suivant ces guides pour la conception de modules complémentaires Google Meet.
Bonnes pratiques d'autorisation
Nous vous encourageons à suivre les bonnes pratiques ci-dessous pour tous les modules complémentaires Google Meet qui nécessitent une authentification ou une autorisation.
Utiliser Google Sign-in
De nombreux utilisateurs de modules complémentaires Google Workspace se seront déjà connectés à Google avant de rejoindre la réunion. Par conséquent, proposer Google One Tap comme option peut permettre à vos utilisateurs de gagner plusieurs clics lors du processus de connexion. Pour en savoir plus, consultez Gérer les méthodes de connexion pour votre module complémentaire.
Ouvrir la page de connexion tierce dans une nouvelle fenêtre
En plus de Google Sign-in, votre application peut proposer d'autres mécanismes de connexion. Dans ce cas, utilisez une fenêtre de dialogue au lieu d'ouvrir une page de connexion dans un nouvel onglet. Ainsi, l'utilisateur peut toujours voir l'appel Meet et y revenir, et il aura moins de clics à effectuer.
Demander correctement les champs d'application pour les API Google
Si votre module complémentaire Meet appelle des API Google, alors 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 de l'application" de Google Workspace Marketplace. Une fois ces champs d'application ajoutés, une invite s'affiche lorsque les utilisateurs installent votre module complémentaire Meet. Elle leur indique le type de données auxquelles ils autorisent l'accès de votre application.
Avant de publier votre module complémentaire, vous devez également configurer l'écran de consentement OAuth. Pour cela, vous devez ajouter exactement les mêmes champs d'application d'autorisation que ceux de la configuration de votre application Google Workspace Marketplace. La configuration de l'écran de consentement OAuth nécessite également de définir les informations de branding, les règles de confidentialité et les conditions d'utilisation qui s'affichent lorsque des champs d'application sont demandés. Pour publier publiquement, toutes ces informations doivent être envoyées pour vérification.
Lorsque vous écrivez du code pour appeler les API Google Workspace, le moyen le plus simple de commencer est de suivre le guide de démarrage rapide JavaScript Quickstart. Cette approche respecte les bonnes pratiques d'utilisation de Google Sign-in et des fenêtres de dialogue. Notez que l'initialisation du jeton client en JavaScript nécessite de demander séparément les champs d'application 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 "Configuration de l'application" de Google Workspace Marketplace. Cette redondance permet de gérer le cas où un utilisateur a révoqué des champs d'application.
Bonnes pratiques de maintenance
Les bonnes pratiques suivantes concernent l'écriture d'applications Web maintenables, mais elles sont particulièrement importantes lorsque vous écrivez des 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 mis à jour régulièrement. Il respecte la gestion sémantique des versions . 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 le fichierpackage.jsondu 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 le 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 leur cache ou que le cache expirera. Par conséquent, nous vous recommandons de ne pas déployer de 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 qui est publié en privé pour votre organisation. Ce projet Cloud hébergera 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 des environnements alternatifs 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 avoir des fichiers manifestes qui pointent vers les environnements alternatifs de votre application Web. Nous vous recommandons ensuite 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 à la tester.
- 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 les éléments suivants :
- 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.
- Tester unitairement toutes les fonctionnalités de votre module complémentaire qui ne sont pas liées au SDK avec votre framework de test Web préféré.
Bonnes pratiques en matière d'expérience utilisateur
Les bonnes pratiques suivantes permettent de 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 effectuées par l'utilisateur 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 entrent dans le
ActivityStartingState
doivent être définies par l'initiateur du module complémentaire (généralement
l'organisateur 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
startActivity()
méthode, vous ne devez laisser le panneau
latéral ouvert que s'il s'agit d'un élément essentiel
de l'expérience utilisateur de votre module complémentaire Google Meet. Vous pouvez fermer
le panneau latéral une fois la scène principale
ouverte en appelant la
unloadSidePanel()
méthode.
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 Promouvoir votre module complémentaire via le partage d'écran.
Consignes de conception de logo
Suivez ces consignes lorsque vous concevez votre logo spécifique à Meet pour qu'il soit optimal aujourd'hui et à l'avenir :
Utilisez le format de fichier PNG, d'une taille de 256 x 256 pixels.
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 pour les modules complémentaires Meet.
Vérifiez que votre logo (et les autres éléments graphiques) s'affichent correctement en mode contraste élevé à l'aide d'un vérificateur de contraste tel que Contrast Checker by Web Accessibility In Mind (WebAIM).
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 aux limites de votre fichier.