La procedura per creare un componente aggiuntivo di Google Workspace che fornisca soluzioni di conferenza di terze parti di Google Calendar è essenzialmente la stessa per la creazione dei componenti aggiuntivi di Google Workspace, con alcuni passaggi aggiuntivi (mostrati in grassetto di seguito):
- Scegli il proprietario e i collaboratori di un componente aggiuntivo per il progetto.
- Creare un progetto Apps Script.
- Progetta l'aspetto e il comportamento dei componenti aggiuntivi.
- Attivare 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 schede integrato di Apps Script.
- Scrivi il codice per gestire le soluzioni di conferenza, utilizzando il servizio integrato di Apps Script
ConferenceData. - (Facoltativo) Crea e configura una pagina delle impostazioni dei componenti aggiuntivi.
- Scrivi il codice per gestire le soluzioni di conferenza, utilizzando il servizio integrato di Apps Script
- Verifica gli ambiti OAuth del componente aggiuntivo.
- Testa il componente aggiuntivo all'interno delle applicazioni host che estende.
- Pubblicare il componente aggiuntivo.
Questa pagina fornisce una panoramica generale di ciascuno dei nuovi passaggi (vedi Creare componenti aggiuntivi di Google Workspace per una panoramica degli altri passaggi).
Attivare 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 di eventi di Calendar, possono essere eseguite solo utilizzando il servizio avanzato. Prima di poter utilizzare il servizio avanzato, devi abilitarlo per il tuo progetto di componente aggiuntivo.
Puoi abilitare il servizio avanzato di 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 API di Google.
Definisci le soluzioni per le conferenze nel manifest
Il file manifest del componente aggiuntivo fornisce le informazioni di base necessarie a Google Calendar per visualizzare e attivare correttamente le soluzioni di conferenza aggiuntive. Il file manifest del componente aggiuntivo deve definire (nella sezione calendar) una o più soluzioni per conferenze che descrivano i tipi di conferenze di terze parti utilizzabili dagli eventi di Google Calendar.
Per informazioni dettagliate su come configurare il file manifest del componente aggiuntivo, consulta Manifest.
Aggiungi 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. Per controllare questo comportamento, puoi utilizzare il servizio avanzato di Calendar, il servizio ConferenceData e altri servizi Apps Script.
Quando aggiungi il codice per la gestione delle conferenze al componente aggiuntivo, devi aggiungerlo per creare conferenze, sincronizzare le modifiche al calendario e, facoltativamente, aggiungere una pagina di impostazioni.
Per le linee guida su come progettare l'esperienza utente dei componenti aggiuntivi, consulta la guida di stile per i componenti aggiuntivi mentre scrivi il codice.
Creazione di conferenze
Il componente aggiuntivo deve essere in grado di acquisire informazioni sull'evento di Google Calendar e utilizzarlo per creare una conferenza sul sistema per conferenze di terze parti. Devi implementare uno o più metodi onCreateFunction che eseguono questo processo e configurarli nel file manifest del componente aggiuntivo.
Per maggiori dettagli, vedi Creare conferenze di terze parti.
Sincronizza 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 apportate all'evento. Ad esempio, se un utente modifica l'orario dell'evento, i dati della conferenza nel sistema di conferenza di terze parti devono essere aggiornati per riflettere questo cambiamento. Il processo di aggiornamento dei dati delle conferenze in risposta alle modifiche degli eventi è chiamato sincronizzazione.
Per maggiori dettagli, vedi Sincronizzare le modifiche al calendario.
Aggiungi impostazioni
È possibile che tu abbia bisogno di impostazioni facoltative che consentano agli utenti di configurare il componente aggiuntivo. Ad esempio, potresti voler consentire agli utenti di impostare i relativi parametri o le note collegate alla conferenza.
Se vuoi offrire agli utenti un certo controllo sul comportamento dei componenti aggiuntivi, puoi inserire queste opzioni nella pagina delle impostazioni dei componenti aggiuntivi. Si tratta di una pagina web (ospitata dallo script del componente aggiuntivo oppure ospitata esternamente) che viene aperta quando l'utente accede alle impostazioni del componente aggiuntivo nell'interfaccia utente di Google Calendar.
La creazione di una pagina di impostazioni per i componenti aggiuntivi è facoltativa. Per maggiori dettagli, vedi Aggiungere impostazioni.