Panoramica delle conferenze di terze parti

Durante la creazione o la modifica di un evento di Google Calendar, gli utenti hanno la possibilità di creare rapidamente una riunione di Google Meet e associarla all'evento. Una volta aggiunti, i partecipanti all'evento possono entrare facilmente nell' Hangout associato con un semplice clic.

Tuttavia, se un utente vuole utilizzare una conferenza di terze parti (come WebEx) anziché Google Meet, la procedura è più complessa. In genere, l'utente deve creare la conferenza all'esterno di Google Calendar e poi copiare il codice nella descrizione dell'evento di Calendar. I partecipanti all'evento devono quindi seguire una serie di passaggi specifici per accedere alla conferenza utilizzando il codice fornito.

I componenti aggiuntivi di Google Workspace possono aiutare gli utenti a evitare questa complessità. Puoi creare un componente aggiuntivo di Google Workspace che estende Google Calendar con soluzioni per conferenze di terze parti. Ogni soluzione di conferenza aggiunta aggiunge una nuova opzione di conferenza per gli eventi di Calendar, consentendo agli utenti di creare e partecipare direttamente da Google Calendar.

Se sei un fornitore di servizi di conferenze, puoi creare un componente aggiuntivo di Google Workspace per definire una connessione tra Google Calendar e il tuo prodotto. Potrai quindi pubblicare il componente aggiuntivo in Google Workspace Marketplace, dove utenti e amministratori possono scoprirlo e installarlo.

Soluzioni per conferenze

Una soluzione per conferenze rappresenta un tipo di conferenza di terze parti a cui gli utenti possono partecipare. Ogni soluzione viene mostrata come un'opzione di conferenza che l'utente può scegliere quando crea o modifica un evento di Google Calendar.

Ecco alcuni esempi di soluzioni di conferenza che un componente aggiuntivo potrebbe definire:

  • una videoconferenza standard
  • una conferenza in modalità solo audio
  • una conferenza personale
  • una conferenza trasmessa in streaming pubblicamente

Qualsiasi tipo di conferenza fornito dal servizio di terze parti può avere una soluzione associata, mentre le raccolte di soluzioni possono essere raggruppate in un unico componente aggiuntivo di Google Workspace.

Come funzionano le soluzioni per conferenze

Quando una soluzione per conferenze viene aggiunta a un componente aggiuntivo di Google Workspace, non è necessario fornire una UI dettagliata. Ogni volta che un utente crea o modifica un evento di Google Calendar, qualsiasi soluzione definita nei componenti aggiuntivi di Google Workspace che l'utente ha installato vengono visualizzate come opzioni di conferenza.

Quando un utente seleziona una soluzione per conferenze, il componente aggiuntivo si connette al sistema di videoconferenza di terze parti utilizzando la relativa API e crea la conferenza, sincronizzando i dati tra la conferenza e l'evento di Google Calendar. Se l'evento viene aggiornato o eliminato in un secondo momento, il componente aggiuntivo lo rileva ed esegue gli aggiornamenti corrispondenti sul sistema di videoconferenza. Una volta allegata la conferenza a un evento, i partecipanti possono partecipare da Google Calendar.

Facoltativamente, il componente aggiuntivo può fornire una pagina delle impostazioni per consentire agli utenti di controllare il comportamento specifico delle conferenze.

Dati della conferenza

I componenti aggiuntivi di Google Workspace che forniscono soluzioni di conferenza per Google Calendar richiedono informazioni specifiche, dati sulle conferenze, per consentire agli utenti di partecipare a conferenze di terze parti. Quando definisci una soluzione per conferenze nel tuo componente aggiuntivo, specifichi una onCreateFunction che crea e restituisce un oggetto ConferenceData. L'oggetto ConferenceData deve contenere tutti i dati della conferenza necessari a Google Calendar oppure un oggetto ConferenceError che descriva un errore che si è verificato durante la comunicazione con il sistema di conferenze di terze parti.

La tabella riportata di seguito descrive ogni tipo di dati di conferenza che il componente aggiuntivo può utilizzare ed elenca l'oggetto del servizio ConferenceData che li rappresenta. Ogni oggetto ConferenceData utilizzato dal componente aggiuntivo deve avere tutti gli elementi contrassegnati come obbligatori:

Componente Tipo Descrizione
Errori di conferenza ConferenceError Obbligatorio se si è verificato un errore, nel qual caso non sono necessari altri dati. Utilizza questa opzione per segnalare un problema che si è verificato quando il componente aggiuntivo ha tentato di connettersi al sistema di videoconferenza.
ID conferenza string Obbligatorio se non è un errore.
Utilizza questo ID per identificare la conferenza all'interno del sistema di conferenza di terze parti.
Parametri conferenza ConferenceParameter[] Utilizza queste coppie chiave-valore per trasmettere qualsiasi informazione specifica del sistema a e dal sistema di videoconferenza di terze parti. Ad esempio, il sistema potrebbe richiedere l'email del moderatore della conferenza o una chiave della riunione.
Note della conferenza string Utilizzalo per aggiungere un avviso di testo alla conferenza. In genere, li utilizzi per aggiungere istruzioni per gli amministratori delle conferenze o note legali.
Entry point EntryPoint[] Obbligatorio se non si tratta di un errore, nel qual caso è necessario definire almeno un EntryPoint.
Utilizza EntryPoint per descrivere un modo specifico di partecipare alla conferenza (ad esempio tramite telefono, video o SIP). Ogni punto di ingresso richiede un URI e un EntryPointType.

Per approfondire

La seguente documentazione può aiutarti a saperne di più: