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, devi 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 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 plug-in installato per la prima volta, devi autorizzarlo.

Per maggiori dettagli, consulta Pubblicare i 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 plug-in, 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 il completamento del componente aggiuntivo. Se l'utente rifiuta l'autorizzazione al componente aggiuntivo, non potrà utilizzarlo.

I componenti aggiuntivi dell'editor utilizzano un modello di autorizzazione diverso da quello dei componenti aggiuntivi di Google Workspace. Poiché i componenti aggiuntivi di 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 plug-in di Editor, è importante comprendere le diverse modalità e come un plug-in passa da una 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 su cui installare il componente aggiuntivo.
  2. Viene visualizzato l'elenco delle autorizzazioni necessarie per il funzionamento del componente aggiuntivo, in modo che tu sappia 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 sarà utilizzabile.
  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 successivamente aggiornato e richiede autorizzazioni aggiuntive che non hai ancora concesso, ti verrà chiesto di fornire queste autorizzazioni la prossima volta che utilizzerai il componente aggiuntivo.

Autorizzare i 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 invece al primo tentativo di utilizzo del componente aggiuntivo.

Quando viene eseguito un componente aggiuntivo, viene stabilito se è necessaria l'autorizzazione dell'utente. Se è necessaria l'autorizzazione, il componente aggiuntivo mostra una scheda di autorizzazione. L'autorizzazione è sempre richiesta 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 precedentemente autorizzato. Il pulsante Autorizza accesso fornisce una finestra di dialogo che consente all'utente di 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 colleghi 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 distinte da parte dell'utente:

  • Autorizzazione del componente aggiuntivo stesso 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 altre 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 videoconferenza che richiedono all'utente di accedere, deve consentirgli di farlo.

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

Al ricevimento di 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 continuare a utilizzare il componente aggiuntivo.

Per ulteriori dettagli sulla gestione dell'autorizzazione utilizzando ConferenceError, consulta la sezione Creare conferenze di terze parti.

Autorizzare i componenti aggiuntivi dell'editor non pubblicati

È buona norma testare i componenti aggiuntivi di Editor durante lo sviluppo. Il flusso di autorizzazione è identico a quello per i componenti aggiuntivi di Editor pubblicati, tranne per il fatto che inizia quando provi per la prima volta a testare il componente aggiuntivo. Se in un secondo momento provi di nuovo lo stesso componente aggiuntivo, non ti verrà chiesta di nuovo l'autorizzazione.

Annullare l'autorizzazione dei componenti aggiuntivi

Quando sviluppi componenti aggiuntivi, può essere utile annullarne l'autorizzazione per 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 averlo annullato, viene visualizzato di nuovo il flusso di autorizzazione.

Disinstallare componenti aggiuntivi

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

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