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 Esplora azioni di fogli connessi, segnalalo all'indirizzo [e-mail].

Questa pagina descrive come attivare e utilizzare l'opzione di link rapido a 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 all'interno del 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 quanto segue:

• Un'istanza di Looker che è stata attivata e configurata per la funzionalità da un amministratore, come descritto nella sezione Attivazione e configurazione del link rapido a Fogli connessi di questa pagina
• Un account utente Looker con l'autorizzazione explore per i modelli LookML che vuoi collegare a 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.

Utilizzo del link rapido a Fogli connessi da un'esplorazione

Se l'amministratore di Looker ha attivato 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 è necessario creare una query in Explore; puoi lasciare vuoto il campo Explore.

3. Fai clic sull'icona a forma di ingranaggio 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 connesso 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.

Abilitazione e configurazione del link rapido a Fogli connessi

Per attivare il link rapido a 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 connessioni sicure pubbliche o connessioni ibride. Le istanze di connessioni private (accesso ai servizi privati) di Looker (Google Cloud core) 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 console Google Cloud .
• Crea un client OAuth nella console Google Cloud nello stesso progetto della console Google Cloud in cui è stata abilitata l'API Google Sheets.
• Attiva e configura l'opzione Abilita il link rapido a Fogli connessi nella pagina Connettori BI di Looker.

Abilitazione dell'API Google Sheets nella console Google Cloud

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, segui questi passaggi:

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

   Vai all'API Google Sheets

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

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

Crea il client OAuth

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

Puoi configurare il client OAuth in qualsiasi progetto Google Cloud che preferisci. Tuttavia, l'API Google Sheets deve essere abilitata nello 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 Google Cloud selezionato, la console Google Cloud visualizzerà un avviso con un pulsante Configura la schermata per il consenso. Fai clic sul pulsante e segui la procedura riportata nella pagina della documentazione di Workspace Configura la schermata per il consenso OAuth e scegli gli ambiti, quindi torna a questa procedura.

Per creare il client e le relative credenziali, segui questi passaggi:

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

   Vai alla console Google Cloud

2. Utilizza il menu principale della console Google Cloud 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 la finestra Client OAuth creato. Questa finestra mostra l'ID client e il client secret creati dalla console Google Cloud per il tuo client OAuth. Copia e prendi nota di questi valori, poiché saranno necessari quando configuri l'opzione di link rapido Abilita Fogli connessi.

Configurazione dell'opzione Abilita il link rapido a Fogli connessi

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

1. Nell'istanza di Looker, seleziona Connettori BI dalla sezione Piattaforma del pannello Amministrazione.
2. Attiva l'opzione Fogli Google se non è già attiva (puoi anche attivare il client Fogli connessi preconfigurato nella pagina Gestisci client OAuth; le impostazioni tra le due pagine sono sincronizzate).
3. Attiva l'opzione nidificata Abilita il link rapido a Fogli connessi.
4. Nei campi ID client e Client secret, incolla i valori che hai copiato dalla console Google Cloud quando hai creato il client OAuth nella console Google Cloud .
5. Fai clic su Salva.

L'opzione Fogli connessi nel menu a forma di ingranaggio Azioni di Esplora è ora configurata per la tua istanza di Looker.

Migrazione dal programma pilota

Se la tua organizzazione ha partecipato al precedente programma pilota per la funzionalità Apri in Fogli, l'istanza di Looker ha utilizzato 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 continuità delle funzionalità.

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

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

Una volta che un amministratore ha completato 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 selezioni 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 attivato la funzionalità nelle impostazioni dei connettori BI. Contatta l'amministratore di Looker per ricevere assistenza.
• Autorizzazioni della consoleGoogle Cloud : 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 progetto Google Cloud .
• Per altri problemi o feedback durante il periodo di Anteprima pubblica, invia un'email all'indirizzo [e-mail].