La procedura per creare un componente aggiuntivo di Google Workspace che fornisca soluzioni di conferenza di terze parti per Calendar è la stessa della procedura per creare componenti aggiuntivi, con alcuni passaggi aggiuntivi (mostrati in grassetto di seguito):
- Scegli un proprietario e dei collaboratori per il progetto dei componenti aggiuntivi.
- Crea un progetto Google Apps Script.
- Progetta l'aspetto e il comportamento del componente aggiuntivo.
- Attiva il servizio avanzato di Calendar.
- Configura il manifest del progetto del componente aggiuntivo.
- Scrivi il codice per definire l'aspetto e il
comportamento del componente aggiuntivo utilizzando il
servizio Card integrato di Apps Script.
- Scrivi codice per gestire le soluzioni per conferenze,
utilizzando il servizio
ConferenceDataintegrato di Apps Script. - (Facoltativo) Crea e configura una pagina delle impostazioni del componente aggiuntivo.
- Scrivi codice per gestire le soluzioni per conferenze,
utilizzando il servizio
- Verifica gli ambiti OAuth del componente aggiuntivo.
- Testa il componente aggiuntivo all'interno delle applicazioni host che estende.
- Pubblica il componente aggiuntivo.
Questa pagina fornisce una panoramica generale di ciascuno dei nuovi passaggi (consulta Creazione di componenti aggiuntivi per una panoramica degli altri passaggi).
Abilita il servizio avanzato di Calendar
Il servizio avanzato Calendar ti consente di chiamare l'API Calendar direttamente da un progetto Apps Script. Alcune operazioni standard, come la sincronizzazione degli eventi di Calendar, possono essere eseguite solo utilizzando il servizio avanzato. Prima di poter utilizzare il servizio avanzato, abilitalo per il progetto del componente aggiuntivo.
Puoi attivare il servizio avanzato Calendar dall'editor di Apps Script. Assicurati di abilitare l'API sia nella finestra di dialogo Servizi avanzati di Google dell'editor sia nella console Google Cloud.
Per coerenza e precisione, utilizza il servizio avanzato Calendar o il servizio Calendar integrato, non entrambi. Se attivi il servizio avanzato Calendar, utilizzalo esclusivamente in tutto il codice.
Definisci le soluzioni per conferenze nel manifest
Il manifest dell'add-on fornisce le informazioni di base
necessarie a Calendar per visualizzare e attivare le
soluzioni di conferenza dell'add-on. Il manifest
del componente aggiuntivo deve definire (nella
sezione calendar) una o più
soluzioni per conferenze che descrivono i tipi di conferenze di terze parti
che possono essere utilizzate negli eventi di Calendar.
Per maggiori dettagli su come configurare il manifest del componente aggiuntivo, vedi Manifest.
Aggiungere il codice per creare e sincronizzare le conferenze
Dopo aver creato un progetto di script, puoi aggiungere codice per definire il comportamento del componente aggiuntivo relativo alle conferenze. Puoi utilizzare il servizio avanzato Calendar, il servizio ConferenceData e altri servizi Apps Script per controllare questo comportamento.
Man mano che aggiungi il codice di gestione delle conferenze al componente aggiuntivo, aggiungi il codice per creare conferenze, sincronizzare le modifiche del calendario e, facoltativamente, aggiungere una pagina delle impostazioni.
Consulta la guida di stile dei componenti aggiuntivi mentre scrivi il codice per le linee guida su come progettare l'esperienza utente del componente aggiuntivo.
Creare conferenze
Il componente aggiuntivo deve essere in grado di acquisire informazioni sull'evento di Calendar e utilizzarle per creare una conferenza sul sistema di conferenza di terze parti. Implementa uno o più metodi onCreateFunction
che eseguono questo processo e configura questi metodi nel
manifest dell'add-on.
Per maggiori dettagli, vedi Creare conferenze di terze parti.
Sincronizzare le modifiche del calendario
Dopo aver creato una conferenza e averla collegata a un evento di Calendar, spesso è necessario aggiornarla per riflettere le modifiche apportate all'evento. Ad esempio, se un utente modifica l'ora dell'evento, i dati della conferenza nel sistema di conferenze di terze parti devono essere aggiornati di conseguenza. La procedura di aggiornamento dei dati della conferenza in risposta alle modifiche dell'evento è chiamata sincronizzazione.
Per maggiori dettagli, vedi Sincronizzare le modifiche al calendario.
Aggiungere impostazioni
Potresti voler disporre di impostazioni facoltative che consentano agli utenti di configurare il tuo componente aggiuntivo. Ad esempio, potresti voler consentire agli utenti di impostare parametri o note della conferenza allegati alla conferenza.
Ogni volta che vuoi offrire agli utenti un certo grado di controllo sul comportamento del componente aggiuntivo, puoi fornire queste opzioni in una pagina delle impostazioni del componente aggiuntivo. Si tratta di una pagina web (ospitata dallo script del componente aggiuntivo o esternamente) che viene aperta quando l'utente accede alle impostazioni del componente aggiuntivo nell'interfaccia utente di Calendar.
La creazione di una pagina delle impostazioni del componente aggiuntivo è facoltativa. Per maggiori dettagli, vedi Aggiungere impostazioni.