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 attivare e utilizzare l'opzione di 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 quanto segue:

• Un'istanza di Looker abilitata e configurata per la funzionalità da un amministratore, come descritto nella sezione Abilitare e configurare il link rapido a Fogli connessi di questa pagina
• Un account utente Looker con l'autorizzazione explore per i modelli LookML a cui vuoi connetterti 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 abilitato la funzionalità, puoi avviare una connessione tra Google Fogli 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 in Esplora, puoi lasciare vuoto Esplora.

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

Attivare e configurare il link rapido a 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:

• La tua 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 sicure pubbliche o 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 collegamento 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 progetto della console in cui è stata abilitata l'API Google Sheets. Google Cloud
• 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, pertanto 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 console, Google Cloud vai ad API e servizi > Libreria e apri l'API Google Sheets.

   Vai all'API Google Sheets

2. Nella Google Cloud console Apri il selettore di progetti, 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 tutta la procedura di configurazione del collegamento 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.

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 . 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 mostrerà una notifica con un pulsante Configura schermata per il consenso. Fai clic sul pulsante e segui la procedura 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 console Google Cloud , utilizza il selettore di progetti della console Google Cloud per aprire lo stesso progetto in cui hai attivato l'API Google Sheets.

   Vai alla Google Cloud console

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

3. Nella pagina Credenziali, fai clic sul menu a discesa Crea credenziali e 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 che la console Google Cloud ha creato per il tuo client OAuth. Copia e annota questi valori, in quanto saranno necessari quando configurerai l'opzione di collegamento rapido Attiva Fogli connessi.

Configurare l'opzione Abilita il link rapido a Fogli connessi

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

1. Nella tua istanza di Looker, seleziona Connettori BI nella sezione Piattaforma del pannello Amministrazione.
2. Attiva il pulsante di attivazione/disattivazione Google Fogli se non è già attivo.
3. Attiva l'opzione secondaria Abilita il link rapido a Fogli connessi.
4. Nei campi ID client e Client secret, incolla i valori copiati 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 esplorazione è 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, la tua istanza di Looker utilizzava un client OAuth gestito centralmente fornito da Looker. Questa configurazione verrà ritirata 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à della 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 di amministrazione di Looker BI Connectors. I passaggi sono gli stessi della configurazione iniziale, descritti in queste sezioni della pagina:

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

Una volta completati questi passaggi, la tua 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'email:se si verifica un errore durante il passaggio di autenticazione 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 Esplora azioni solo se l'amministratore di Looker ha attivato la funzionalità nelle impostazioni di BI Connectors. Contatta l'amministratore di Looker per ricevere assistenza.
• 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 progetto Google Cloud .Google Cloud
• Per altri problemi o feedback durante il periodo di Anteprima pubblica, invia un'email all'indirizzo [e-mail].