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 in che modo gli utenti possono installare, autorizzare e per iniziare a usare i componenti aggiuntivi.

Installare componenti aggiuntivi

Prima di poter utilizzare un componente aggiuntivo, devi installarlo. Una volta installato, il componente aggiuntivo diventa disponibile nel Google Workspace applicazione host si 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 di Google Workspace Marketplace. Puoi anche installare componenti aggiuntivi non pubblicati che stai sviluppando per poterli testare. Prima di poter utilizzare un modello installato per la prima volta, devi autorizzare li annotino.

Per ulteriori dettagli, vedi Pubblicare componenti aggiuntivi.

Autorizzare i componenti aggiuntivi

Dopo l'installazione, un componente aggiuntivo diventa disponibile in Google Workspace applicazione host si estende. La prima volta che un utente tenta di utilizzare un componente aggiuntivo, l'applicazione host li presenta finestra di dialogo o scheda di autorizzazione. Questa scheda spiega cosa il componente aggiuntivo deve disporre dell'autorizzazione necessaria per l'utente, ad esempio accedendo ai contenuti del foglio Google corrente. L'utente può quindi concedere queste autorizzazioni e consentire il completamento del componente aggiuntivo. Se l'utente nega il componente aggiuntivo autorizzazione, non potranno utilizzare il componente aggiuntivo.

I componenti aggiuntivi dell'editor utilizzano un modello di autorizzazione diverso da quello dei componenti aggiuntivi di 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 i singoli file. Durante lo sviluppo dei componenti aggiuntivi dell'editor, è importante comprendere le diverse modalità e come un componente aggiuntivo si sposta tra di loro.

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. 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 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 installato viene aggiornato in un secondo momento e richiede autorizzazioni non ancora concesse, ti verrà chiesto di fornirle le 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 elencate in Google Workspace Marketplace. Dopo il giorno installando un componente aggiuntivo non pubblicato, che non ti viene chiesto subito di autorizzare. Al contrario, il flusso di autorizzazione viene avviata al primo tentativo di utilizzare il componente aggiuntivo.

Quando viene eseguito un componente aggiuntivo, determina 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

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 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 per accedere a un servizio non Google tramite OAuth, devi configura 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

Componenti aggiuntivi di Google Workspace che estendono Google Calendar puoi anche aggiungere altri soluzioni per conferenze che consentono agli utenti di selezionare un sistema di videoconferenza di terze parti durante la modifica Eventi di Google Calendar. Se il componente aggiuntivo fornisce opzioni di videoconferenza richiedere all'utente di accedere, il componente aggiuntivo deve offrire all'utente la possibilità per farlo.

Se un utente tenta di creare una conferenza con il tuo componente aggiuntivo senza accedi, il metodo onCreateFunction delle soluzioni di conferenza dovrebbe restituire un ConferenceData contenente 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 continuare a utilizzare il componente aggiuntivo.

Consulta la sezione Creazione di conferenze di terze parti. per maggiori dettagli sulla gestione dell'autorizzazione mediante ConferenceError.

Autorizzare componenti aggiuntivi dell'editor non pubblicati

È consigliabile 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 al primo tentativo di 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 di 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.