Les modules complémentaires Google Workspace qui ajoutent des solutions de conférence comportent souvent des informations qui doivent être contrôlées par l'utilisateur depuis une page de paramètres de module complémentaire. Par exemple, il est courant d'avoir un bouton ou une commande permettant à un utilisateur de se déconnecter du système de conférence tiers.
Les pages de paramètres des modules complémentaires sont facultatives. Les sections suivantes décrivent comment ouvrir la page de paramètres d'un module complémentaire et en créer une.
Ouvrir les paramètres du module complémentaire
Pour ouvrir la page des paramètres d'un module complémentaire que vous avez installé, procédez comme suit :
- Ouvrez Google Agenda.
- Cliquez sur l'icône , puis sélectionnez Paramètres.
- Dans le panneau de navigation de gauche, sélectionnez Modules complémentaires pour accéder à la liste des modules complémentaires installés.
- Cliquez sur le bouton Paramètres qui s'affiche à droite du nom du module complémentaire pour ouvrir la page des paramètres de ce module complémentaire. Google Agenda ouvre alors l'URL de la page des paramètres.
Si un module complémentaire ne définit pas de page de paramètres, le bouton Paramètres ne s'affiche pas.
Créer une page de paramètres
Une page de paramètres est généralement créée à l'aide de code HTML et CSS standard. Lorsque vous concevez votre page, suivez les consignes de style pour les modules complémentaires.
Lorsqu'un utilisateur modifie les paramètres du module complémentaire, la page doit envoyer des requêtes au système de conférence tiers pour appliquer ces modifications, le cas échéant. La page peut également stocker et récupérer des informations à partir des propriétés utilisateur du projet de module complémentaire si nécessaire.
Hébergé sur un serveur Web externe
Vous pouvez héberger votre page de paramètres de module complémentaire en externe à partir du projet de script du module complémentaire, par exemple sur le site Web de la solution de visioconférence tierce.
Pour associer un module complémentaire à une page de paramètres externe, procédez comme suit:
- Créez la page et hébergez-la en externe. Lorsque vous ajoutez des éléments à la page, assurez-vous qu'ils communiquent correctement avec le système de conférence tiers et apportez les modifications appropriées pour cet utilisateur.
- Dans le projet de script du module complémentaire, implémentez une fonction qui renvoie l'URL de la page externe.
- Spécifiez le nom de cette fonction comme champ
calendar.createSettingsFunctiondans le fichier manifeste du projet du module complémentaire.
Hébergé dans Apps Script
Vous pouvez fournir une page de paramètres pour votre module complémentaire à l'aide d'une application Web Apps Script. En tant qu'application Web, votre projet de script de module complémentaire peut créer et déployer la page, qui est ensuite hébergée sur les serveurs Apps Script.
Consultez le guide du service HTML pour savoir comment créer du code HTML pour les applications Web. Votre page de paramètres peut communiquer avec les serveurs Google si nécessaire. Vous pouvez également utiliser des modèles sur la page pour la rendre plus dynamique.
L'exemple de module complémentaire de conférence Calendar montre comment créer une page de paramètres d'application Web.