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 le propriétaire du projet du module complémentaire et des collaborateurs.
- 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 du module complémentaire.
- É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éer et configurer 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 fournit une présentation générale de chacune des nouvelles étapes (consultez la section 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 les 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 complémentaires. 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é Agenda, 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 être en mesure de prendre des informations sur l'événement Google Agenda et de 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 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 en conséquence. Le processus de mise à jour des données de conférence en réponse aux modifications d'événements est appelé synchronisation.
Pour en savoir plus, consultez Synchroniser les modifications apportées à 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 du module complémentaire est facultative. Pour en savoir plus, consultez Ajouter des paramètres.