La procedura per creare un componente aggiuntivo di Google Workspace che fornisce soluzioni di videoconferenze di terze parti per Google Calendar è essenzialmente la stessa della procedura per la creazione di componenti aggiuntivi di Google Workspace, con alcuni passaggi aggiuntivi (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 file manifest del progetto del componente aggiuntivo.
- Scrivi il codice per definire l'aspetto e il comportamento del componente aggiuntivo utilizzando il servizio Scheda di Apps Script integrato.
- Scrivi codice per gestire le soluzioni per le conferenze,
utilizzando il servizio integrato
ConferenceDatadi Apps Script. - (Facoltativo) Crea e configura una pagina delle impostazioni del componente aggiuntivo.
- Scrivi codice per gestire le soluzioni per le conferenze,
utilizzando il servizio integrato
- Verifica gli ambiti OAuth del componente aggiuntivo.
- Testa il componente aggiuntivo all'interno delle app host che estende.
- Pubblica il componente aggiuntivo.
Questa pagina fornisce una panoramica generale di ciascuno dei nuovi passaggi (consulta Creare componenti aggiuntivi di Google Workspace per una panoramica degli altri passaggi).
Abilita il servizio avanzato di Calendar
Il servizio avanzato di Calendar 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 attivarlo per il progetto del tuo componente aggiuntivo.
Puoi abilitare il servizio avanzato di Calendar dall'editor di Apps Script. Assicurati di attivare l'API sia nella finestra di dialogo editor Servizi Google avanzati sia nella console API di Google.
Definisci le soluzioni per conferenze nel manifest
Il manifest del componente aggiuntivo fornisce le informazioni di base di cui ha bisogno Google Calendar per visualizzare e attivare correttamente le soluzioni di conferenza dei componenti aggiuntivi. Il manifest del componente aggiuntivo deve definire (nella sezione calendar) una o più soluzioni per le conferenze che descrivono i tipi di conferenze di terze parti che possono essere utilizzati dagli eventi di Google Calendar.
Per maggiori dettagli su come configurare il manifest del tuo componente aggiuntivo, consulta la sezione Manifest.
Aggiungi il codice per creare e sincronizzare le conferenze
Dopo aver 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 di Calendar, il servizio ConferenceData e altri servizi di Apps Script per controllare questo comportamento.
Quando aggiungi il codice di gestione delle conferenze al tuo componente aggiuntivo, devi aggiungere codice per creare conferenze, sincronizzare le modifiche al calendario e, facoltativamente, aggiungere una pagina delle impostazioni.
Consulta la guida di stile dei componenti aggiuntivi durante la codifica per avere indicazioni su come progettare l'esperienza utente del componente aggiuntivo.
Creazione di conferenze
Il componente aggiuntivo deve essere in grado di acquisire le 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 questa procedura e configurarli nel file manifest del componente aggiuntivo.
Per maggiori dettagli, vedi Creare conferenze di terze parti.
Sincronizzare le modifiche al calendario
Una volta creata e collegata a un evento di Google Calendar, la conferenza spesso deve essere aggiornata per riflettere le modifiche dell'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 degli eventi è chiamato sincronizzazione.
Per maggiori dettagli, vedi Sincronizzare le modifiche al calendario.
Aggiungere impostazioni
Potresti voler avere impostazioni facoltative che consentano agli utenti di configurare il tuo componente aggiuntivo. Ad esempio, potresti voler consentire agli utenti di impostare i parametri o le note della conferenza collegati 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 (in hosting nello script del componente aggiuntivo o in hosting esterno) che si apre quando l'utente accede alle impostazioni del componente aggiuntivo nell'interfaccia utente di Google Calendar.
La creazione di una pagina delle impostazioni del componente aggiuntivo è facoltativa. Per maggiori dettagli, vedi Aggiungere impostazioni.