La procédure de création d'un module complémentaire Google Workspace qui fournit des solutions de conférence tierces Google Agenda est essentiellement la même que la procédure de création de modules complémentaires Google Workspace, avec quelques étapes supplémentaires (en gras ci-dessous):
- Choisissez un propriétaire et des collaborateurs pour le projet de module complémentaire.
- Créez un projet Apps Script.
- Concevez l'apparence et le comportement de votre module complémentaire.
- Activez le service avancé Agenda.
- Configurez le fichier manifeste du projet de l'extension.
- Écrivez du code pour définir l'apparence et le comportement du module complémentaire à l'aide du service de fiche intégré à Apps Script.
- Écrivez du code pour gérer des solutions de conférence à l'aide du service
ConferenceData
intégré à Apps Script. - (Facultatif) Créez et configurez une page de paramètres de module complémentaire.
- Écrivez du code pour gérer des solutions de conférence à l'aide du service
- Vérifiez les niveaux d'accès OAuth de votre module complémentaire.
- Testez le module complémentaire dans les applications hôtes qu'il étend.
- Publiez le module complémentaire.
Cette page offre un aperçu général de chacune des nouvelles étapes (consultez Créer des modules complémentaires Google Workspace pour en savoir plus sur les autres étapes).
Activer le service avancé Agenda
Le service avancé de Calendar vous permet d'appeler l'API Calendar directement à partir d'un projet Apps Script. Certaines opérations courantes telles que la synchronisation des événements d'agenda ne peuvent être effectuées qu'à l'aide du service avancé. Avant de pouvoir utiliser le service avancé, vous devez l'activer pour votre projet de module complémentaire.
Vous pouvez activer le service avancé Agenda depuis l'éditeur Apps Script. Veillez à activer l'API à la fois dans la boîte de dialogue Services Google avancés de l'éditeur et dans la console des API Google.
Définir des solutions de conférence dans le fichier manifeste
Le fichier manifeste du module complémentaire fournit les informations de base dont Google Agenda a besoin pour afficher et activer correctement les solutions de conférence du module complémentaire. Le fichier manifeste de votre module complémentaire doit définir (dans sa section calendar
) une ou plusieurs solutions de conférence qui décrivent les types de conférences tierces que les événements Google Agenda peuvent utiliser.
Pour savoir comment configurer le fichier manifeste de votre module complémentaire, consultez la section Fichiers manifestes.
Ajouter du code pour créer et synchroniser des conférences
Une fois que vous avez créé un projet de script, vous pouvez commencer à ajouter du code pour définir le comportement du plug-in lié aux conférences. Vous pouvez utiliser le service avancé de Calendrier, le service ConferenceData et d'autres services Apps Script pour contrôler ce comportement.
Lorsque vous ajoutez du code de gestion des conférences à votre module complémentaire, vous devez ajouter du code pour créer des conférences, synchroniser les modifications de l'agenda et éventuellement ajouter une page de paramètres.
Consultez le guide de style des modules complémentaires lorsque vous codez pour obtenir des conseils sur la conception de l'expérience utilisateur de votre module complémentaire.
Créer des conférences
Votre module complémentaire doit pouvoir récupérer des informations sur l'événement Google Agenda et les utiliser pour créer une conférence sur le système de conférence tiers. Vous devez implémenter une ou plusieurs méthodes onCreateFunction
qui exécutent ce processus, et configurer ces méthodes dans le fichier manifeste de votre module complémentaire.
Pour en savoir plus, consultez la section Créer des conférences tierces.
Synchroniser les modifications apportées à l'agenda
Une fois qu'une conférence a été créée et associée à un événement Google Agenda, elle doit souvent être mise à jour pour refléter les modifications apportées à l'événement. Par exemple, si un utilisateur modifie l'heure de l'événement, les données de la conférence dans le système de conférence tiers doivent être mises à jour pour refléter ce changement. Le processus de mise à jour des données de la conférence en réponse aux modifications d'événements s'appelle la synchronisation.
Pour en savoir plus, consultez la section Synchroniser les modifications de l'agenda.
Ajouter des paramètres
Vous pouvez ajouter des paramètres facultatifs permettant aux utilisateurs de configurer votre module complémentaire. Par exemple, vous pouvez autoriser les utilisateurs à définir des paramètres ou des notes associés à la conférence.
Chaque fois que vous souhaitez donner aux utilisateurs un certain contrôle sur le comportement du module complémentaire, vous pouvez fournir ces options sur une page de paramètres du module complémentaire. Il s'agit d'une page Web (hébergée par le script du module complémentaire ou hébergée en externe) qui s'ouvre lorsque l'utilisateur accède aux paramètres du module complémentaire dans l'interface utilisateur de Google Agenda.
La création d'une page de paramètres de module complémentaire est facultative. Pour en savoir plus, consultez la section Ajouter des paramètres.