Améliorez l'expérience globale de vos utilisateurs en suivant ces guides de conception des modules complémentaires Google Meet.
Bonnes pratiques en matière d'autorisation
Nous vous encourageons à suivre les bonnes pratiques ci-dessous pour tous les modules complémentaires Google Meet nécessitant 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, le fait de proposer Google One Tap comme option peut faire gagner plusieurs clics à vos utilisateurs lorsqu'ils suivent le 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 la connexion avec Google, votre application peut proposer d'autres mécanismes de connexion. 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 l'appel Meet et y revenir, et le nombre total de clics est réduit.
Demander correctement des autorisations pour les API Google
Si votre module complémentaire Meet appelle des API Google, vous devez fournir une liste complète des niveaux d'accès OAuth requis par votre module complémentaire. Pour ce faire, accédez à la page de configuration de l'application Google Workspace Marketplace. Après avoir ajouté ces niveaux d'accès, vos utilisateurs verront une invite lorsqu'ils installeront votre module complémentaire Meet. Cette invite leur indiquera le type de données auxquelles ils autorisent votre application à accéder.
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 niveaux d'autorisation que ceux 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 autorisations sont demandées. Pour publier publiquement, toutes ces informations doivent être envoyées pour validation.
Lorsque vous écrivez du code pour appeler les API Google Workspace, le moyen le plus simple de commencer est de suivre le démarrage rapide JavaScript. Cette approche respecte les bonnes pratiques d'utilisation de la connexion avec Google et des fenêtres de dialogue. Notez que l'initialisation du client de jetons en JavaScript nécessite de demander séparément les autorisations que l'application utilise réellement au moment de l'exécution. Pour une expérience utilisateur optimale, ces niveaux d'accès demandés doivent correspondre à ceux de la page de configuration de l'application Google Workspace Marketplace. Cette redondance permet de gérer le cas où un utilisateur a révoqué des autorisations.
Bonnes pratiques concernant la maintenance
Les bonnes pratiques suivantes concernent l'écriture d'applications Web maintenables, 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 incluse 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.jsonpour le site Web qui héberge votre module complémentaire Meet.
Créer un projet Google Cloud intermédiaire
Une fois votre module complémentaire Google Meet publié sur Google Workspace Marketplace, tout nouveau déploiement de votre module complémentaire Google Meet est instantanément disponible pour les utilisateurs de Meet. Les utilisateurs verront ces modifications dès qu'ils videront leur cache ou que le cache expirera. Par conséquent, nous vous recommandons de ne pas transférer les modifications vers 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é de manière privée dans 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 les 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 intermédiaire. Ces nouveaux déploiements doivent comporter 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 mode 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.
- Effectuez des tests unitaires de toutes les fonctionnalités non liées au SDK de votre module complémentaire avec votre framework de test Web préféré.
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épart dans le panneau latéral
Nous vous recommandons vivement de configurer votre module complémentaire en fonction des actions effectuées par les 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 insérées dans 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.
Fermez le panneau latéral lorsque vous ne l'utilisez pas.
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 fait partie intégrante de l'expérience utilisateur de votre module complémentaire Google Meet. Vous pouvez fermer le panneau latéral une fois que la scène principale est ouverte en appelant la méthode unloadSidePanel().
Promouvoir votre module complémentaire Meet grâce au 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 par le biais du partage d'écran.
Consignes de conception des logos
Suivez ces consignes lorsque vous concevez votre logo spécifique à Meet pour qu'il soit le plus esthétique possible aujourd'hui 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 pour les modules complémentaires Meet.
Vérifiez que votre logo (et vos autres éléments graphiques) s'affichent correctement en mode Contraste élevé à l'aide d'un outil de vérification du contraste tel que Contrast Checker de Web Accessibility In Mind (WebAIM).
Respectez les exigences concernant les éléments 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.