La procedura per creare un componente aggiuntivo di Google Workspace che fornisce soluzioni di conferenza di terze parti per Google Calendar è essenzialmente la stessa della procedura per creare componenti aggiuntivi di Google Workspace, con alcuni passaggi aggiuntivi (mostrati in grassetto di seguito):
- Scegli un proprietario e dei collaboratori per il progetto del componente aggiuntivo.
- Crea un progetto 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 di conferenza,
utilizzando il servizio
ConferenceDataintegrato di Apps Script. - (Facoltativo) Crea e configura una pagina delle impostazioni del componente aggiuntivo.
- Scrivi codice per gestire le soluzioni di conferenza,
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 di Google Workspace 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 comuni, come la sincronizzazione degli eventi di Calendar, possono essere eseguite solo utilizzando il servizio avanzato. Prima di poter utilizzare il servizio avanzato, devi abilitarlo 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 Google avanzati che nella console API di Google.
Definisci le soluzioni per conferenze nel manifest
Il manifest dell'componente aggiuntivo fornisce le informazioni di base necessarie a Google Calendar
per visualizzare e attivare correttamente le soluzioni di conferenza del componente aggiuntivo. Il manifest del componente aggiuntivo
deve definire (nella
sezione calendar)
una o più soluzioni di conferenza che descrivono i tipi di conferenze di terze parti
che possono essere utilizzate dagli eventi di Google Calendar.
Per maggiori dettagli su come configurare il manifest del componente aggiuntivo, vedi Manifest.
Aggiungere il codice per creare e sincronizzare le conferenze
Una volta creato un progetto di script, puoi iniziare ad aggiungere codice per definire il comportamento relativo alle conferenze del componente aggiuntivo. 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, devi aggiungere 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 durante la codifica 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 Google Calendar
e utilizzarle per creare una conferenza sul sistema di conferenze di terze parti. Devi
implementare uno o più metodi onCreateFunction che eseguono questo
processo e configurare questi metodi nel manifest del componente aggiuntivo.
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 Google 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. Il processo di aggiornamento dei dati della conferenza in risposta alle modifiche dell'evento è chiamato sincronizzazione.
Per maggiori dettagli, vedi Sincronizzare le modifiche del calendario.
Aggiungere impostazioni
Potresti voler disporre di impostazioni facoltative che consentano agli utenti di configurare il componente aggiuntivo. Ad esempio, potresti voler consentire agli utenti di impostare parametri o note della conferenza che vengono allegati alla conferenza.
Ogni volta che vuoi fornire 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 all'interno dell'interfaccia utente di Google Calendar.
La creazione di una pagina delle impostazioni del componente aggiuntivo è facoltativa. Per maggiori dettagli, vedi Aggiungere impostazioni.