Installare e autorizzare componenti aggiuntivi

Gli utenti devono installare e autorizzare un componente aggiuntivo prima di può aprirlo e usarlo. Poiché questi passaggi sono la prima parte l'esperienza utente dei componenti aggiuntivi, dovresti 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.

Installa componenti aggiuntivi

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

Puoi installare i componenti aggiuntivi pubblicati dal dall'applicazione host Google Workspace o 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.

Autorizza 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 potrà quindi concedere autorizzazioni e consentire al componente aggiuntivo di continuare. Se l'utente nega il componente aggiuntivo autorizzazione, non possono usare il componente aggiuntivo.

I componenti aggiuntivi dell'editor utilizzano un modello di autorizzazione diverso Componenti aggiuntivi di Google Workspace. Poiché i Componenti aggiuntivi dell'Editor funzionano sui file di Google Drive, il dell'editor di codice definisce varie modalità di autorizzazione che risultano i componenti aggiuntivi vengono utilizzati con 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 del componente aggiuntivo. richiede di operare, in modo che tu sappia cosa cerca di fare. Recensisci attentamente e, se vuoi comunque concedere l'autorizzazione, fai clic su Consenti. In questo modo il componente aggiuntivo può essere utilizzato.
  3. Ora puoi eseguirlo applicazione host si estende. Se l'applicazione era già aperta in una scheda del browser, potresti aggiornare la scheda prima che il componente aggiuntivo diventi disponibile.

Se il componente aggiuntivo installato viene aggiornato in un secondo momento e richiede che non hai ancora concesso, 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 se l'autorizzazione è necessaria, il componente aggiuntivo presenta una scheda di autorizzazione. L'autorizzazione è sempre obbligatoria la prima volta che un componente aggiuntivo viene eseguito. Inoltre, può anche necessaria se una nuova versione del componente aggiuntivo utilizza un servizio che in precedenza autorizzati. Il pulsante Autorizza accesso fornisce una finestra di dialogo per in Consenti o Rifiuta 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. Componenti aggiuntivi di Google Workspace che si connettono a questi servizi richiedono due azioni separate da parte dell'utente:

  • Autorizzazione del componente aggiuntivo stesso al momento dell'installazione o della prima a iniziare.
  • 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 ulteriori informazioni, consulta Collega il tuo componente aggiuntivo di Google Workspace a un servizio di terze parti.

Sistemi di conferenza 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.

Alla ricezione di questo oggetto, Google Calendar crea un pulsante ACCEDI in la UI 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 ulteriormente l'utilizzo del componente aggiuntivo.

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

Autorizza componenti aggiuntivi non pubblicati dell'editor

È una best practice per testare i componenti aggiuntivi dell'Editor man mano che le sviluppi. Il flusso di autorizzazione è identico per i componenti aggiuntivi dell'editor pubblicati, ad eccezione del flusso viene avviata al primo tentativo di testare il componente aggiuntivo. Se in un secondo momento esegui nuovamente il test il 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 poterli testare nuovamente nel 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 nuovamente il componente aggiuntivo dopo averne annullato l'autorizzazione, il flusso viene presentato di nuovo.