Aggiunta delle impostazioni dei componenti aggiuntivi per conferenze

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 videoconferenze di terze parti.

Le pagine di impostazioni dei componenti aggiuntivi sono facoltative. Le sezioni seguenti descrivono come aprire la pagina delle impostazioni di un componente aggiuntivo e come crearne una.

Apri le impostazioni del componente aggiuntivo

Per aprire la pagina delle impostazioni di un componente aggiuntivo che hai installato, segui questi passaggi:

  1. Apri Google Calendar.
  2. Fai clic sull'icona e seleziona Impostazioni.
  3. Nel riquadro di navigazione a sinistra, seleziona Componenti aggiuntivi per passare all'elenco dei componenti aggiuntivi installati.
  4. 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, Google 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

In genere, una pagina delle impostazioni viene creata utilizzando HTML e CSS standard. Quando progetti la tua pagina, segui le linee guida relative allo stile dei componenti aggiuntivi.

Quando un utente apporta modifiche alle impostazioni del componente aggiuntivo, la pagina deve inviare richieste al sistema di conferenze di terze parti per applicare le modifiche in modo appropriato. La pagina può anche memorizzare e recuperare le informazioni dalle proprietà utente del progetto del componente aggiuntivo, se necessario.

Ospitato su un server web esterno

Puoi ospitare la pagina di impostazioni del componente aggiuntivo esternamente dal progetto dello script del componente aggiuntivo, ad esempio all'interno del sito web di conferenze di terze parti.

Per collegare un componente aggiuntivo a una pagina di impostazioni esterna, devi procedere nel seguente modo:

  1. Crea la pagina e ospitala esternamente. Quando aggiungi elementi alla pagina, assicurati che comunichino correttamente con il sistema di conferenze di terze parti e apporta le modifiche appropriate per l'utente.
  2. Nel progetto dello script del componente aggiuntivo, implementa una funzione che restituisce l'URL per la pagina esterna.
  3. Specifica il nome di questa funzione come campo calendar.createSettingsFunction nel manifest del progetto del componente aggiuntivo.

Ospitato in Apps Script

Puoi fornire una pagina di impostazioni per il tuo componente aggiuntivo utilizzando un'app web di Apps Script. Come app web, il progetto di script del componente aggiuntivo può compilare ed eseguire il deployment della pagina, che viene poi ospitata sui server di Apps Script.

Consulta la guida al servizio HTML per informazioni dettagliate su come creare HTML per le app web. La pagina delle impostazioni può comunicare con i server Google in base alle necessità. Puoi anche utilizzare i modelli nella pagina per renderla più dinamica.

L'esempio di componente aggiuntivo per le conferenze di Calendar mostra come creare una pagina delle impostazioni dell'app web.