Vínculo rápido de Hojas conectadas

Vista previa: Esta función está sujeta a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Si tienes algún problema durante la versión preliminar pública de la opción del menú de ajustes Acciones de Explorar de Hojas conectadas, infórmalo a [e-mail].

En esta página, se describe cómo habilitar y usar la opción de vínculo rápido Hojas conectadas del menú de ajustes Acciones de Explorar en Looker. La opción Hojas conectadas abre Hojas de cálculo de Google y establece una conexión entre Hojas de cálculo de Google y el Explorar de Looker. Luego, puedes crear informes, tablas dinámicas o gráficos en la Hoja de cálculo de Google recién creada con los campos de la exploración de Looker seleccionada.

Antes de comenzar

Para usar el vínculo rápido de Hojas conectadas, necesitas lo siguiente:

• Una instancia de Looker que un administrador habilitó y configuró para la función, como se describe en la sección Cómo habilitar y configurar el vínculo rápido de Hojas conectadas de esta página
• Una cuenta de usuario de Looker con el permiso explore para los modelos de LookML a los que deseas conectarte en Hojas
• Una Cuenta de Google con la misma dirección de correo electrónico asociada a tu cuenta de Looker

Nota: Esta función no está disponible para los usuarios de Looker integrado.

Cómo usar el vínculo rápido de Hojas conectadas desde un Explorar

Si tu administrador de Looker habilitó la función, puedes iniciar una conexión entre Hojas de cálculo de Google y cualquier Explorar al que tengas acceso:

1. Accede a Looker con la dirección de correo electrónico asociada a tu Cuenta de Google.

2. En Looker, navega a la exploración que deseas usar como fuente de datos.

   Nota: No es necesario que crees una consulta en Explorar; puedes dejar Explorar en blanco.

3. Haz clic en el ícono de ajustes Acciones de Explorar y selecciona Hojas conectadas.

4. La primera vez que uses esta función, se te pedirá que autorices a Looker a acceder a tu Cuenta de Google. Elige la Cuenta de Google que deseas usar. La dirección de correo electrónico de la Cuenta de Google debe coincidir con la dirección de correo electrónico asociada a tu cuenta de usuario de Looker.

5. Revisa los permisos que se solicitan en la pantalla de consentimiento y haz clic en Permitir.

6. Se abrirá una pestaña nueva del navegador en Hojas de cálculo de Google y aparecerá un diálogo en el que se te preguntará si quieres vincular tu Cuenta de Google con tu cuenta de Looker. Haz clic en Vincular cuenta.

Ahora, la hoja de cálculo de Google está conectada a la exploración de Looker desde la que comenzaste. En la hoja de cálculo de Google, puedes agregar campos desde la función Explorar, crear tablas dinámicas, generar gráficos y aplicar fórmulas para analizar los datos de tu exploración de Looker.

Consulta la página de documentación Usa Hojas conectadas para Looker para obtener más información sobre cómo crear consultas en Hojas conectadas.

Cómo habilitar y configurar el vínculo rápido de Hojas conectadas

Para habilitar el vínculo rápido de Hojas conectadas en el menú de ajustes Acciones de Explorar, tu instancia de Looker debe cumplir con los siguientes requisitos:

• Tu instancia debe ejecutar Looker 25.20 o una versión posterior.
• En el caso de las instancias de Looker (Google Cloud Core), el vínculo rápido de Hojas conectadas solo se admite para las conexiones de red de conexiones seguras públicas o conexiones híbridas. No se admiten las instancias de Looker (Google Cloud Core) con conexiones privadas (acceso a servicios privados).
• En el caso de las instancias de Looker (original), el vínculo rápido de Hojas conectadas solo es compatible con las instancias alojadas en Looker. No se admiten las instancias de Looker alojadas por el cliente.

Para habilitar la opción Hojas conectadas en el menú de ajustes Acciones de Explorar de una instancia de Looker, un administrador debe realizar estas tareas generales, que se describen en las siguientes secciones:

• Habilita la API de Google Sheets en la consola de Google Cloud .
• Crea un cliente de OAuth en la Google Cloud consola en el mismo proyecto de la Google Cloud consola en el que se habilitó la API de Google Sheets.
• Habilita y configura la opción Habilitar el vínculo rápido de Hojas conectadas en la página de conectores de BI de Looker.

Habilita la API de Google Sheets en la consola de Google Cloud

El vínculo rápido de Hojas conectadas usa la API de Google Sheets, por lo que esta API debe estar activada en el mismo proyecto que usarás para crear el cliente de OAuth. Un usuario de IAM con el permiso de IAM roles/serviceusage.serviceUsageAdmin puede habilitar la API de Hojas de cálculo de Google.

Sigue estos pasos para habilitar la API de Google Sheets:

1. En el menú de navegación de la consola de Google Cloud , ve a APIs y servicios > Biblioteca y abre la API de Google Sheets.

   Ir a la API de Google Sheets

2. En el Google Cloud selector de proyectos de la consola, abrir, selecciona el proyecto que deseas usar para conectarte a Hojas de cálculo de Google desde tus Explorar de Looker. Debes usar el mismo proyecto de la consola durante todo el procedimiento de configuración del vínculo rápido de Hojas conectadas para que la API de Google Sheets esté habilitada en el mismo proyecto en el que configures OAuth. Google Cloud

3. En la página de la API de Hojas de cálculo de Google, haz clic en Habilitar si la API aún no está habilitada.

Crea el cliente de OAuth

Un usuario de IAM con los roles requeridos debe crear un cliente de OAuth.

Puedes configurar el cliente de OAuth en cualquier proyecto Google Cloud que desees. Sin embargo, la API de Google Sheets debe estar habilitada en este mismo proyecto.

Nota: Antes de que puedas generar tus credenciales de OAuth, Google requiere que configures una pantalla de consentimiento de OAuth, que permite que los usuarios elijan cómo otorgar acceso a sus datos privados. Si aún no configuraste una pantalla de consentimiento de OAuth para el proyecto de la consola Google Cloud que seleccionaste, la consola Google Cloud mostrará un aviso con un botón Configurar pantalla de consentimiento. Haz clic en el botón y sigue el procedimiento que se indica en la página de documentación del espacio de trabajo Configura la pantalla de consentimiento de OAuth y elige permisos. Luego, vuelve a este procedimiento.

Para crear el cliente y sus credenciales, sigue estos pasos:

1. En la consola de Google Cloud , usa el selector de proyectos abiertos de la consola de Google Cloud para abrir el mismo proyecto en el que habilitaste la API de Google Sheets.

   Ir a la consola de Google Cloud

2. Usa el menú principal de la consola de Google Cloud para navegar a APIs y servicios > Credenciales.

3. En la página Credenciales, haz clic en el menú desplegable Crear credenciales y, luego, selecciona ID de cliente de OAuth.

4. En el menú desplegable Tipo de aplicación, selecciona Aplicación web.

5. En el campo Nombre, ingresa un nombre para tu cliente de OAuth, como Looker to Connected Sheets.

6. En la sección URI de redireccionamiento autorizados, haz clic en el botón Agregar URI. Agrega el siguiente URI:

   https://LOOKER_INSTANCE_URL/oauth2callback
   

7. Haz clic en el botón Agregar URI para agregar también el siguiente URI:

   https://LOOKER_INSTANCE_URL/external_oauth/redirect
   

8. Haz clic en Crear.

9. Después de hacer clic en Crear, aparecerá una ventana de Cliente de OAuth creado. En esta ventana, se muestran el ID de cliente y el secreto del cliente que la consola de Google Cloud creó para tu cliente de OAuth. Copia estos valores y toma nota de ellos, ya que los necesitarás cuando configures la opción de vínculo rápido Habilitar Hojas conectadas.

Cómo configurar la opción del vínculo rápido Habilitar Hojas conectadas

Después de habilitar la API de Google Sheets en la consola de Google Cloud y crear el cliente de OAuth en la consola de Google Cloud , puedes habilitar el vínculo rápido de Hojas conectadas en tu instancia de Looker siguiendo estos pasos:

1. En tu instancia de Looker, selecciona BI Connectors en la sección Platform del panel Admin.
2. Habilita el botón de activación o desactivación de Hojas de cálculo de Google si aún no está habilitado.
3. Habilita el botón de activación anidado Habilitar el vínculo rápido de Hojas conectadas.
4. En los campos ID de cliente y Secreto del cliente, pega los valores que copiaste de la consola de Google Cloud cuando creaste el cliente de OAuth en la consola de Google Cloud .
5. Haz clic en Guardar.

La opción Hojas conectadas del menú de ajustes Acciones de Explorar ahora está configurada para tu instancia de Looker.

Migración desde el programa piloto

Si tu organización participó en el programa piloto anterior para la función Abrir en Hojas de cálculo, tu instancia de Looker usó un cliente OAuth administrado de forma centralizada que proporcionó Looker. Esta configuración se dejará de usar en favor del método más seguro y escalable en el que cada administrador de Looker configura su propio cliente de OAuth para su instancia de Looker. Los clientes piloto existentes deben migrar a esta nueva configuración para garantizar la continuidad de la funcionalidad.

Para migrar a la nueva versión, un administrador debe configurar el cliente OAuth propio de tu organización en la consola de Google Cloud y, luego, configurar las credenciales en la página de administrador de los conectores de BI de Looker. Los pasos son los mismos que los de la configuración inicial, que se describen en estas secciones de esta página:

• Habilita la API de Google Sheets en la consola de Google Cloud
• Crea un cliente de OAuth en la consola de Google Cloud en el mismo proyecto de la consola de Google Cloud en el que se habilitó la API de Google Sheets.
• Habilita y configura la opción Habilitar el vínculo rápido de Hojas conectadas en la página Conectores de IE de Looker

Una vez que el administrador complete estos pasos, tu instancia usará automáticamente el nuevo flujo de OAuth administrado por el cliente. La funcionalidad de la versión piloto anterior y su dependencia del cliente de OAuth administrado por Looker ya no estarán activas.

Soluciona problemas

• Error de discrepancia de correo electrónico: Si se produce un error durante el paso de autenticación de Google, asegúrate de que la Cuenta de Google que selecciones tenga exactamente la misma dirección de correo electrónico que tu cuenta de usuario de Looker.
• No se ve la opción"Hojas conectadas": Esta opción aparecerá en el menú de ajustes Explorar acciones solo si el administrador de Looker habilitó la función en la configuración de BI Connectors. Comunícate con tu administrador de Looker para obtener asistencia.
• Google Cloud Permisos de la consola: El administrador que configura el cliente de OAuth y la pantalla de consentimiento debe tener los permisos roles/oauthconfig.editor y roles/serviceusage.serviceUsageAdmin en el proyecto Google Cloud .
• Si tienes otros problemas o comentarios durante el período de la versión preliminar pública, envía un correo electrónico a [e-mail].