Installare e autorizzare componenti aggiuntivi

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

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

Installare componenti aggiuntivi

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

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

Per maggiori dettagli, vedi Pubblicare componenti aggiuntivi.

Autorizzare i componenti aggiuntivi

Dopo l'installazione, un componente aggiuntivo diventa disponibile nell'applicazione host di Google Workspace che estende. La prima volta che un utente tenta di utilizzare il componente aggiuntivo, l'applicazione host gli presenta una scheda o una finestra di dialogo di autorizzazione. Questa scheda spiega cosa deve fare il componente aggiuntivo per l'utente, ad esempio accedere 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 al componente aggiuntivo, non potrà utilizzarlo.

I componenti aggiuntivi dell'editor utilizzano un modello di autorizzazione diverso da quello dei componenti aggiuntivi Google Workspace. Poiché i componenti aggiuntivi dell'editor operano sui file di Google Drive, il modello di autorizzazione dell'editor definisce varie modalità di autorizzazione che si verificano quando i componenti aggiuntivi vengono utilizzati con singoli file. Quando sviluppi componenti aggiuntivi per Editor, è importante comprendere le diverse modalità e come un componente aggiuntivo passa da una modalità all'altra.

Autorizzare 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 in cui installare il componente aggiuntivo.
  2. Viene quindi visualizzato l'elenco delle autorizzazioni richieste dal componente aggiuntivo per funzionare, in modo da sapere cosa tenta di fare. Esamina 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, potresti dover aggiornare la scheda prima che il componente aggiuntivo diventi disponibile.

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

Autorizzare 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 di quelli pubblicati perché non sono ancora elencati in Google Workspace Marketplace. Dopo aver installato un componente aggiuntivo non pubblicato, non ti viene chiesto immediatamente di autorizzare. Il flusso di autorizzazione inizia al primo tentativo di utilizzo del componente aggiuntivo.

Quando viene eseguito un componente aggiuntivo, viene determinato se è necessaria un'autorizzazione utente. Se è necessaria l'autorizzazione, il componente aggiuntivo presenta una scheda di autorizzazione. L'autorizzazione è sempre necessaria la prima volta che viene eseguito un componente aggiuntivo e potrebbe essere richiesta 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.

Autorizzare servizi non Google per un componente aggiuntivo di Google Workspace

È possibile che un componente aggiuntivo di Google Workspace si connetta a un servizio di terze parti che 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 quando 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 utilizzando OAuth, devi configurare la connessione per quel servizio durante la creazione del componente aggiuntivo.

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

Sistemi di videoconferenza di terze parti

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

Se un utente tenta di creare una conferenza con il tuo componente aggiuntivo senza un accesso necessario, il metodo onCreateFunction della soluzione per conferenze deve restituire un oggetto ConferenceData contenente un ConferenceError con un URL di autenticazione.

Una volta ricevuto questo oggetto, Google Calendar crea un pulsante ACCEDI nell'interfaccia utente di modifica dell'evento che rimanda 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.

Per maggiori dettagli sulla gestione dell'autorizzazione tramite ConferenceError, consulta Creazione di conferenze di terze parti.

Autorizzare i componenti aggiuntivi dell'editor non pubblicati

È consigliabile testare i componenti aggiuntivi dell'editor durante lo sviluppo. Il flusso di autorizzazione è identico a quello per i componenti aggiuntivi dell'editor pubblicati, tranne per il fatto che il flusso inizia quando tenti di testare il componente aggiuntivo per la prima volta. Se in un secondo momento esegui di nuovo il test dello stesso componente aggiuntivo, non ti viene chiesto di nuovo di autorizzarlo.

Annullare l'autorizzazione dei componenti aggiuntivi

Durante lo sviluppo dei componenti aggiuntivi, può essere utile annullare l'autorizzazione per poter testare nuovamente il flusso di autorizzazione.

Per annullare l'autorizzazione di un componente aggiuntivo:

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

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

Disinstallare componenti aggiuntivi

Per disinstallare un componente aggiuntivo installato da Google Workspace Marketplace, consulta Disinstallare un'app o un componente aggiuntivo del Marketplace.

Per disinstallare un componente aggiuntivo non pubblicato creato in Apps Script, consulta Disinstallare un componente aggiuntivo non pubblicato.