I componenti aggiuntivi di Google Workspace che aggiungono soluzioni per le conferenze spesso hanno dettagli che devono essere controllati dall'utente da una pagina delle impostazioni del componente aggiuntivo. Ad esempio, è comune avere un pulsante o un controllo che consente a un utente di uscire dal sistema di conferenza di terze parti.
Le pagine delle impostazioni dei componenti aggiuntivi sono facoltative. Le sezioni seguenti descrivono come aprire la pagina delle impostazioni di un componente aggiuntivo e come crearne una.
Aprire le impostazioni dei componenti aggiuntivi
Le impostazioni dei componenti aggiuntivi per le conferenze sono accessibili dal menu delle impostazioni di Calendar. Per aprire la pagina delle impostazioni di un componente aggiuntivo che hai installato:
- Apri Google Calendar.
- Fai clic sull'icona e seleziona Impostazioni.
- Nel pannello di navigazione a sinistra, seleziona Componenti aggiuntivi per passare all'elenco dei componenti aggiuntivi installati.
- Fai clic sul pulsante Impostazioni visualizzato a destra del nome del componente aggiuntivo per aprire la pagina delle impostazioni del componente aggiuntivo. In questo modo, Calendar aprirà l'URL della pagina delle impostazioni.
Se un componente aggiuntivo non definisce una pagina delle impostazioni, il pulsante Impostazioni non viene visualizzato.
Creare una pagina delle impostazioni
Una pagina delle impostazioni viene creata utilizzando HTML e CSS standard. Quando progetti la pagina, segui le linee guida di stile dei componenti aggiuntivi.
Quando un utente modifica le impostazioni del componente aggiuntivo, la pagina deve inviare richieste al sistema di conferenza di terze parti per applicare queste modifiche. La pagina può anche archiviare e recuperare le informazioni dalle proprietà utente del progetto del componente aggiuntivo, se necessario.
Ospitata su un server web esterno
Puoi ospitare la pagina delle impostazioni del componente aggiuntivo esternamente al progetto di script del componente aggiuntivo, ad esempio come parte del sito web di conferenza di terze parti.
Per collegare un componente aggiuntivo a una pagina delle impostazioni esterna:
- Crea la pagina e ospitala esternamente. Quando aggiungi elementi alla pagina, assicurati che comunichino correttamente con il sistema di conferenza di terze parti e che apportino le modifiche appropriate per l'utente.
- Nel progetto di script del componente aggiuntivo, implementa una funzione che restituisce l'URL della pagina esterna.
- Specifica il nome di questa funzione come
calendar.createSettingsFunctioncampo nel progetto del componente aggiuntivo manifest.
Ospitata in Apps Script
Puoi fornire una pagina delle impostazioni per il tuo componente aggiuntivo utilizzando un'app web Apps Script . Come app web, il progetto di script del componente aggiuntivo può creare ed eseguire il deployment della pagina, che viene poi ospitata sui server di Apps Script.
Per informazioni dettagliate su come creare HTML per le app web, consulta la guida al servizio HTML. La pagina delle impostazioni può comunicare con i server Google , se necessario. Puoi anche utilizzare i modelli nella pagina per renderla più dinamica.
L' esempio del componente aggiuntivo per le conferenze di Calendar mostra come creare una pagina delle impostazioni dell'app web.