Link rapido a Fogli connessi

Anteprima: questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Se riscontri un problema durante l'anteprima pubblica dell'opzione del menu a forma di ingranaggio Azioni di esplorazione di Fogli connessi, segnalalo all'indirizzo [e-mail].

Questa pagina descrive come abilitare e utilizzare l'opzione del link rapido Fogli connessi dal menu a forma di ingranaggio Azioni di esplorazione in Looker. L'opzione Fogli connessi apre Fogli Google e avvia una connessione da Fogli Google all'esplorazione di Looker. Puoi quindi creare report, tabelle pivot o grafici nel foglio Google appena creato utilizzando i campi dell'esplorazione di Looker selezionata.

Prima di iniziare

Per utilizzare il link rapido Fogli connessi, devi disporre di:

• Un'istanza di Looker che è stata abilitata e configurata per la funzionalità da un amministratore, come descritto nella sezione Abilitare e configurare il link rapido Fogli connessi in questa pagina.
• Un account utente Looker con l'autorizzazione explore per i modelli LookML a cui vuoi connettere i fogli.
• Un Account Google con lo stesso indirizzo email associato al tuo account Looker.

Nota: questa funzionalità non è disponibile per gli utenti di Looker Embed.

Utilizzare il link rapido Fogli connessi da un'esplorazione

Se l'amministratore di Looker ha abilitato la funzionalità, puoi avviare una connessione tra Fogli Google e qualsiasi esplorazione a cui hai accesso:

1. Accedi a Looker con l'indirizzo email associato al tuo Account Google.

2. In Looker, vai all'esplorazione che vuoi utilizzare come origine dati.

   **Suggerimento:** non devi creare una query nell'esplorazione; puoi lasciare l'esplorazione vuota.

3. Fai clic sull'icona a forma di ingranaggio delle impostazioni Azioni di esplorazione e seleziona Fogli connessi.

4. La prima volta che utilizzi questa funzionalità, ti verrà chiesto di autorizzare Looker ad accedere al tuo Account Google. Scegli l'Account Google che vuoi utilizzare. L'indirizzo email dell'Account Google deve corrispondere all'indirizzo email associato al tuo account utente Looker.

5. Esamina le autorizzazioni richieste nella schermata per il consenso e fai clic su Consenti.

6. Si apre una nuova scheda del browser in Fogli Google e viene visualizzata una finestra di dialogo che ti chiede se vuoi collegare il tuo Account Google al tuo account Looker. Fai clic su Collega account.

Il foglio Google è ora collegato all'esplorazione di Looker da cui hai iniziato. All'interno del foglio Google, puoi aggiungere campi dall'esplorazione, creare tabelle pivot, creare grafici e applicare formule per analizzare i dati dell'esplorazione di Looker.

Per saperne di più sulla creazione di query in Fogli connessi, consulta la pagina della documentazione Utilizzo di Fogli connessi per Looker.

Abilitare e configurare il link rapido Fogli connessi

Per abilitare il link rapido Fogli connessi nel menu a forma di ingranaggio Azioni di esplorazione, l'istanza di Looker deve soddisfare i seguenti requisiti:

• L'istanza deve eseguire Looker 25.20 o versioni successive.
• Per le istanze di Looker (Google Cloud core), il link rapido Fogli connessi è supportato solo per le connessioni di rete con connessioni sicure pubbliche o connessioni ibride. Le istanze di Looker (Google Cloud core) connessioni private (accesso privato ai servizi) non sono supportate.
• Per le istanze di Looker (originale), il link rapido Fogli connessi è supportato solo per le istanze ospitate da Looker. Le istanze di Looker ospitate dal cliente non sono supportate.

Per abilitare l'opzione Fogli connessi nel menu a forma di ingranaggio Azioni di esplorazione in un'istanza di Looker, un amministratore deve eseguire queste attività generali, descritte nelle sezioni seguenti:

• Abilita l'API Google Sheets nella Google Cloud console.
• Crea un client OAuth nella Google Cloud console nello stesso Google Cloud progetto della console in cui è stata abilitata l'API Google Sheets.
• Abilita e configura l'opzione Abilita il link rapido Fogli connessi nella pagina Connettori BI di Looker.

Abilitare l'API Google Sheets nella Google Cloud console

Il link rapido Fogli connessi utilizza l'API Google Sheets, quindi questa API deve essere attivata nello stesso progetto che utilizzerai per creare il client OAuth. L'API Google Sheets può essere abilitata da un utente IAM con l'autorizzazione IAM roles/serviceusage.serviceUsageAdmin.

Per abilitare l'API Google Sheets:

1. Nel menu di navigazione della Google Cloud console, vai ad API e servizi > Libreria e apri l'API Google Sheets.

   Vai all'API Google Sheets

2. Dal Google Cloud console selettore di progetti, seleziona il progetto che vuoi utilizzare per connetterti a Fogli Google dalle esplorazioni di Looker. Devi utilizzare lo stesso Google Cloud progetto della console durante la procedura di configurazione del link rapido Fogli connessi in modo che l'API Google Sheets sia abilitata nello stesso progetto in cui configuri OAuth.

3. Nella pagina dell'API Google Sheets, fai clic su Abilita se l'API non è già abilitata.

Creare il client OAuth

Un utente IAM con i ruoli richiesti deve creare un client OAuth.

Puoi configurare il client OAuth in qualsiasi Google Cloud progetto. Tuttavia, l'API Google Sheets deve essere abilitata in questo stesso progetto.

Nota: prima di poter generare le credenziali OAuth, Google richiede di configurare una schermata per il consenso OAuth, che consente agli utenti di scegliere come concedere l'accesso ai propri dati privati. Se non hai ancora configurato una schermata per il consenso OAuth per il progetto della console selezionato Google Cloud , la Google Cloud console visualizzerà un avviso con un pulsante Configura schermata per il consenso. Fai clic sul pulsante e segui la procedura descritta nella pagina della documentazione di Workspace Configurare la schermata per il consenso OAuth e scegliere gli ambiti, quindi torna a questa procedura.

Per creare il client e le relative credenziali:

1. Nella Google Cloud console, utilizza il Google Cloud console selettore di progetti per aprire lo stesso progetto in cui hai abilitato l'API Google Sheets.

   Vai alla console Google Cloud

2. Utilizza il Google Cloud menu principale della console per andare ad API e servizi > Credenziali.

3. Nella pagina Credenziali, fai clic sul menu a discesa Crea credenziali, quindi seleziona ID client OAuth.

4. Nel menu a discesa Tipo di applicazione, seleziona Applicazione web.

5. Nel campo Nome, inserisci un nome per il client OAuth, ad esempio Looker to Connected Sheets.

6. Nella sezione URI di reindirizzamento autorizzati, fai clic sul pulsante Aggiungi URI. Aggiungi il seguente URI:

   https://LOOKER_INSTANCE_URL/oauth2callback
   

7. Fai clic sul pulsante Aggiungi URI per aggiungere anche il seguente URI:

   https://LOOKER_INSTANCE_URL/external_oauth/redirect
   

8. Fai clic su Crea.

9. Dopo aver fatto clic su Crea, viene visualizzata una finestra Client OAuth creato. Questa finestra mostra l'ID client e il client secret creati dalla Google Cloud console per il client OAuth. Copia e annota questi valori, perché saranno necessari quando configurerai l'opzione Abilita il link rapido Fogli connessi.

Configurare l'opzione Abilita il link rapido Fogli connessi

Dopo aver abilitato l'API Google Sheets nella Google Cloud console e creato il client OAuth nella Google Cloud console, puoi abilitare il link rapido Fogli connessi nell'istanza di Looker seguendo questi passaggi:

1. Nell'istanza di Looker, seleziona Connettori BI dalla sezione Piattaforma del riquadro Amministrazione.
2. Attiva il pulsante di attivazione/disattivazione Fogli Google se non è già attivo.
3. Attiva il pulsante di attivazione/disattivazione nidificato Abilita il link rapido Fogli connessi.
4. Nei campi ID client e Client secret, incolla i valori che hai copiato dalla Google Cloud console quando hai creato il client OAuth nella Google Cloud console.
5. Fai clic su Salva.

L'opzione Fogli connessi nel menu a forma di ingranaggio Azioni di esplorazione è ora configurata per l'istanza di Looker.

Eseguire la migrazione dal programma pilota

Se la tua organizzazione ha partecipato al precedente programma pilota per la funzionalità Apri in Fogli, l'istanza di Looker utilizzava un client OAuth gestito centralmente fornito da Looker. Questa configurazione è in fase di ritiro a favore del metodo più sicuro e scalabile in cui ogni amministratore di Looker configura il proprio client OAuth per la propria istanza di Looker. I clienti pilota esistenti devono eseguire la transizione a questa nuova configurazione per garantire la funzionalità continua.

Per eseguire la migrazione alla nuova versione, un amministratore deve configurare il client OAuth della tua organizzazione nella Google Cloud console e poi configurare le credenziali nella pagina di amministrazione Connettori BI di Looker. I passaggi sono gli stessi della configurazione iniziale, descritti in queste sezioni di questa pagina:

• Abilitare l'API Google Sheets nella Google Cloud console
• Creare un client OAuth nella Google Cloud console nello stesso progetto della Google Cloud console in cui è stata abilitata l'API Google Sheets
• Abilitare e configurare l'opzione Abilita il link rapido Fogli connessi nella pagina Connettori BI di Looker

Una volta completati questi passaggi, l'istanza utilizzerà automaticamente il nuovo flusso OAuth gestito dal cliente. La funzionalità pilota precedente e la sua dipendenza dal client OAuth gestito da Looker non saranno più attive.

Risoluzione dei problemi

• Errore di mancata corrispondenza dell'indirizzo email: se si verifica un errore durante il passaggio di autenticazione di Google, assicurati che l'Account Google che stai selezionando abbia esattamente lo stesso indirizzo email del tuo account utente Looker.
• Opzione"Fogli connessi" non visibile: questa opzione viene visualizzata nel menu a forma di ingranaggio Azioni di esplorazione solo se l'amministratore di Looker ha abilitato la funzionalità nelle impostazioni Connettori BI. Contatta l'amministratore di Looker per ricevere assistenza.
• Google Cloud Autorizzazioni della console: l'amministratore che configura il client OAuth e la schermata per il consenso deve disporre delle autorizzazioni roles/oauthconfig.editor e roles/serviceusage.serviceUsageAdmin nel Google Cloud progetto.
• Per altri problemi o feedback durante il periodo di anteprima pubblica, invia un'email all'indirizzo [e-mail].