Installare e autorizzare componenti aggiuntivi

Gli utenti devono installare e autorizzare un componente aggiuntivo prima di poterlo aprire e utilizzare. Poiché questi passaggi sono la prima parte dell'esperienza utente dei componenti aggiuntivi, è necessario comprenderli prima di iniziare a creare i tuoi componenti aggiuntivi.

Questa sezione della documentazione descrive in che modo gli utenti possono installare, autorizzare e iniziare a utilizzare i componenti aggiuntivi.

Installa componenti aggiuntivi

Per poter utilizzare un componente aggiuntivo, devi prima installarlo. Una volta installato, il componente aggiuntivo diventa disponibile nell'applicazione host di Google Workspace che si estende.

Puoi installare i componenti aggiuntivi pubblicati dall'applicazione host di Google Workspace o da Google Workspace Marketplace. Gli amministratori di dominio possono anche installare componenti aggiuntivi per conto dei loro utenti da Google Workspace Marketplace. Puoi anche installare componenti aggiuntivi non pubblicati che stai sviluppando in modo da poterli testare. Per poter utilizzare un componente aggiuntivo installato per la prima volta, devi autorizzarlo.

Per maggiori dettagli, consulta Pubblicare componenti aggiuntivi.

Autorizza componenti aggiuntivi

Dopo l'installazione, un componente aggiuntivo diventa disponibile nell'applicazione host di Google Workspace che viene estesa. La prima volta che un utente tenta di utilizzare il componente aggiuntivo, l'applicazione host gli presenta una scheda di autorizzazione o una finestra di dialogo. In questa scheda vengono spiegate le attività del componente aggiuntivo che devono essere svolte dall'utente, ad esempio l'accesso ai contenuti del foglio Google corrente. L'utente può quindi concedere queste autorizzazioni e consentire al componente aggiuntivo di procedere. Se l'utente nega l'autorizzazione dei componenti aggiuntivi, non può utilizzare i componenti aggiuntivi.

I componenti aggiuntivi dell'editor utilizzano un modello di autorizzazione diverso dai componenti aggiuntivi di Google Workspace. Poiché i componenti aggiuntivi dell'editor operano sui file di Google Drive, il modello di autorizzazione dell'editor definisce diverse modalità di autorizzazione che risultano quando i componenti aggiuntivi vengono utilizzati con i singoli file. Durante lo sviluppo di componenti aggiuntivi di Editor, è importante comprendere le diverse modalità e il modo in cui un componente aggiuntivo si sposta da una all'altra.

Autorizza i componenti aggiuntivi pubblicati

Dopo aver installato un componente aggiuntivo pubblicato, il flusso di autorizzazione inizia immediatamente:

  1. Ti viene chiesto di scegliere un account per installare il componente aggiuntivo.
  2. Ti verrà poi presentato l'elenco delle autorizzazioni necessarie per il funzionamento del componente aggiuntivo, in modo che tu sappia cosa cerca di fare. Leggi attentamente questo elenco e, se vuoi comunque concedere l'autorizzazione, fai clic su Consenti. In questo modo il componente aggiuntivo può essere utilizzato.
  3. Ora puoi eseguirlo dall'applicazione host che estende. Se l'applicazione era già aperta in una scheda del browser, potrebbe essere necessario aggiornare la scheda prima che il componente aggiuntivo diventi disponibile.

Se il componente aggiuntivo installato viene aggiornato in un secondo momento e richiede ulteriori autorizzazioni che non hai ancora concesso, ti verrà chiesto di fornire queste autorizzazioni al successivo utilizzo del componente aggiuntivo.

Autorizza componenti aggiuntivi di Google Workspace non pubblicati

Scheda di autorizzazione del componente aggiuntivo

I componenti aggiuntivi non pubblicati non hanno lo stesso flusso di autorizzazione dei componenti aggiuntivi pubblicati perché non sono ancora elencati in Google Workspace Marketplace. Dopo aver installato un componente aggiuntivo non pubblicato, non ti viene chiesto immediatamente di autorizzarlo. Il flusso di autorizzazione inizia quando tenti per la prima volta a utilizzare il componente aggiuntivo.

Quando viene eseguito un componente aggiuntivo, determina se è necessaria l'autorizzazione dell'utente. Se è necessaria l'autorizzazione, il componente aggiuntivo presenta una scheda di autorizzazione. L'autorizzazione è sempre obbligatoria la prima volta che un componente aggiuntivo viene eseguito e può essere necessaria anche se una nuova versione del componente aggiuntivo utilizza un servizio non autorizzato in precedenza. Il pulsante Autorizza accesso fornisce una finestra di dialogo in cui l'utente può consentire o negare l'autorizzazione per il componente aggiuntivo.

Autorizza servizi non Google per un componente aggiuntivo di Google Workspace

Un componente aggiuntivo di Google Workspace può connettersi a un servizio di terze parti che a sua volta richiede l'autorizzazione. I componenti aggiuntivi di Google Workspace che si connettono a questi servizi richiedono due azioni separate da parte dell'utente:

  • Autorizzazione del componente aggiuntivo stesso quando questo viene installato o avviato per la prima volta.
  • Autorizzazione del servizio non Google al primo accesso.

Se un componente aggiuntivo di Google Workspace che stai sviluppando deve accedere a un servizio non Google tramite OAuth, devi configurare la connessione per quel servizio quando crei il componente aggiuntivo.

Per saperne di più, consulta Collegare il componente aggiuntivo di Google Workspace a un servizio di terze parti.

Sistemi di conferenza di terze parti

I componenti aggiuntivi di Google Workspace che estendono Google Calendar possono anche aggiungere ulteriori soluzioni per le conferenze che consentono agli utenti di selezionare un sistema di videoconferenza di terze parti durante la modifica degli eventi di Google Calendar. Se il tuo componente aggiuntivo fornisce opzioni di conferenza che richiedono all'utente di accedere, deve offrire all'utente la possibilità di farlo.

Se un utente tenta di creare una conferenza con il tuo componente aggiuntivo senza dover accedere, il metodo onCreateFunction delle soluzioni di conferenza deve restituire un oggetto ConferenceData contenente un ConferenceError con un URL di autenticazione.

Alla ricezione di questo oggetto, Google Calendar crea un pulsante ACCEDI nell'interfaccia utente di modifica degli eventi che si collega all'URL di autenticazione fornito dal componente aggiuntivo. Gli utenti possono quindi utilizzare questo pulsante per accedere al sistema di terze parti prima di utilizzare ulteriormente il componente aggiuntivo.

Consulta Creazione di conferenze di terze parti per ulteriori dettagli sulla gestione delle autorizzazioni con ConferenceError.

Autorizza componenti aggiuntivi non pubblicati dell'editor

È consigliabile testare i componenti aggiuntivi dell'editor mentre li sviluppi. Il flusso di autorizzazione è identico a quello per i componenti aggiuntivi dell'editor pubblicati, tranne per il fatto che il flusso inizia quando tenti per la prima volta di testare il componente aggiuntivo. Se in un secondo momento ripeti il test dello stesso componente aggiuntivo, non ti verrà più chiesta l'autorizzazione.

Annulla l'autorizzazione dei componenti aggiuntivi

Durante lo sviluppo dei componenti aggiuntivi, può essere utile annullarne l'autorizzazione in modo da poter testare nuovamente il flusso di autorizzazione.

Per annullare l'autorizzazione di un componente aggiuntivo:

  1. Apri la console per la sicurezza dell'account.
  2. Individua e fai clic sul componente aggiuntivo di cui vuoi annullare l'autorizzazione.
  3. Fai clic su Rimuovi accesso.

Quando esegui di nuovo il componente aggiuntivo dopo aver annullato l'autorizzazione, viene presentato di nuovo il flusso di autorizzazione.