La procedura per creare un componente aggiuntivo di Google Workspace che fornisce soluzioni di conferenza di terze parti per Google Calendar è sostanzialmente la stessa della procedura per la creazione di 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 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 il codice per gestire le soluzioni di conferenza,
utilizzando il servizio integrato
ConferenceDatadi Apps Script. - (Facoltativo) Crea e configura una pagina delle impostazioni del componente aggiuntivo.
- Scrivi il codice per gestire le soluzioni di conferenza,
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).
Attivare 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 le sincronizzazioni di 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 abilitare l'API sia nella finestra di dialogo dell'editor Servizi avanzati di Google e nella console API di Google.
Definisci le soluzioni per conferenze nel manifest
Il manifest del componente aggiuntivo fornisce le informazioni di base necessarie a Google Calendar per visualizzare e attivare correttamente le soluzioni per conferenze aggiuntive. 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
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 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 di 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 questo processo e configurare questi metodi nel 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 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 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 consentire agli utenti di impostare i parametri o le note della conferenza da allegare.
Ogni volta che vuoi offrire agli utenti un certo livello di controllo sul comportamento del componente aggiuntivo, puoi fornire queste opzioni nella 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.