i componenti aggiuntivi richiedono l'autorizzazione dell'utente prima di poter essere utilizzati. Questo vale sia per i componenti aggiuntivi pubblicati che hai installato da Google Workspace Marketplace sia per i componenti aggiuntivi che stai sviluppando autonomamente.
Autorizzazione dei componenti aggiuntivi pubblicati
Dopo aver installato un componente aggiuntivo pubblicato, il flusso di autorizzazione inizia immediatamente:
- Ti viene chiesto di scegliere un account per installare il componente aggiuntivo.
- Ti viene quindi presentato l'elenco delle autorizzazioni necessarie per il funzionamento del componente aggiuntivo, in modo che tu possa sapere quali operazioni tenta di eseguire. Esamina attentamente l'elenco e, se desideri comunque concedere l'autorizzazione, fai clic su Consenti. In questo modo è possibile utilizzare il componente aggiuntivo.
- Ora puoi eseguirla 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 ulteriori autorizzazioni che non hai ancora concesso, ti verrà chiesto di fornire tali autorizzazioni al successivo utilizzo del componente aggiuntivo.
Autorizzare componenti aggiuntivi di Google Workspace non pubblicati
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 richiesta immediatamente l'autorizzazione. Il flusso di autorizzazione inizia invece al primo tentativo di utilizzare il componente aggiuntivo.
L'esecuzione di un componente aggiuntivo determina se è necessaria un'autorizzazione dell'utente. Se è necessaria un'autorizzazione, il componente aggiuntivo presenta una scheda di autorizzazione. L'autorizzazione è sempre richiesta alla prima esecuzione di un componente aggiuntivo 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.
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 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 al momento dell'installazione o del primo avvio del componente aggiuntivo.
- 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 il servizio quando crei il componente aggiuntivo.
Quando è richiesta l'autorizzazione di un servizio non Google, il componente aggiuntivo di Google Workspace presenta all'utente una scheda con la richiesta di autorizzazione per il servizio in questione. Se vuoi, puoi personalizzare questa richiesta di autorizzazione oppure utilizzare la carta predefinita.
Per ulteriori dettagli, consulta la guida Collegamento a servizi non Google.
Sistemi di conferenza di terze parti
I componenti aggiuntivi di Google Workspace che estendono Google Calendar possono anche aggiungere soluzioni per conferenze aggiuntive che consentono agli utenti di selezionare un sistema di conferenza di terze parti quando modificano gli eventi di Google Calendar. Se il componente aggiuntivo offre opzioni di conferenza che richiedono l'accesso all'utente, deve consentire all'utente di eseguire questa operazione.
Se un utente tenta di creare una conferenza con il tuo componente aggiuntivo senza eseguire l'accesso necessario, il metodo onCreateFunction delle soluzioni per conferenze 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 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.
Consulta Creazione di conferenze di terze parti per ulteriori dettagli sulla gestione dell'autorizzazione utilizzando ConferenceError.
Autorizzazione di componenti aggiuntivi dell'editor non pubblicati
Come best practice, testa i componenti aggiuntivi dell'editor man mano che li sviluppi. Il flusso di autorizzazione è identico a quello per i componenti aggiuntivi dell'editor pubblicati, tranne per il fatto che si avvia la prima volta che provi a testare il componente aggiuntivo. Se in un secondo momento ripeti il test dello stesso componente aggiuntivo, non ti viene richiesta di nuovo l'autorizzazione.
Annullare l'autorizzazione dei componenti aggiuntivi
Durante lo sviluppo di componenti aggiuntivi, può essere utile annullarne l'autorizzazione in modo da poter ripetere il flusso di autorizzazione.
Per annullare l'autorizzazione di un componente aggiuntivo:
- Apri la Console per la sicurezza del tuo account.
- Individua e fai clic sul componente aggiuntivo di cui vuoi annullare l'autorizzazione.
- Fai clic su RIMUOVI ACCESSO.
Quando esegui di nuovo il componente aggiuntivo dopo averlo annullato, il flusso di autorizzazione viene presentato di nuovo.