La API Action de Looker permite a los desarrolladores definir acciones o destinos personalizados a los que Looker puede enviar resultados de consultas, resultados de paneles de control o interacciones de usuarios.
Una vez que se haya desarrollado una acción, se haya implementado como servicio web y se haya añadido a una instancia de Looker, los usuarios de Looker podrán enviar datos mediante esa acción desde Looker.
Usar acciones
La API Action admite varias variaciones en los casos prácticos:
- Las acciones admiten varios niveles de interactividad del usuario. Pueden diseñarse para interacciones de usuario puntuales mientras un usuario ve un panel de control o para trabajar con programaciones recurrentes o activadas.
- Las acciones pueden indicar a Looker que recoja datos de formularios de los usuarios para parametrizar el tratamiento de los datos.
- Las acciones pueden incluso solicitar la autenticación de usuarios en un servicio de terceros mediante OAuth, por ejemplo, para enviar datos de forma implícita a destinos específicos de los usuarios.
- Las acciones también pueden recibir resultados de consultas en varios formatos, desde formatos orientados a datos, como CSV y Excel, hasta varios formatos JSON para casos prácticos programáticos, pasando por formatos orientados a la visualización, como PNG o PDF.
Aunque estos casos de uso son diversos, tienen en común que los usuarios de Looker pueden indicar a Looker que se ponga en contacto con una acción y le envíe datos.
Por lo tanto, implementar una acción implica desplegar un servicio web para que esté atento a estas solicitudes.
Para ello, puedes añadir algunos endpoints nuevos a un servidor de aplicaciones, desplegar un servidor web exclusivamente para este fin o incluso usar un entorno sin servidor, como las funciones de Google Cloud Run. La API Action no requiere que el servicio mantenga ningún estado entre solicitudes, por lo que los servidores Action pueden beneficiarse de configuraciones de implementación sin estado escalables y flexibles.
Por último, como la API Action consta de solicitudes HTTP POST con formato JSON, se puede usar cualquier lenguaje del lado del servidor para implementar una acción. Looker proporciona varios ejemplos en TypeScript, incluido el código de código abierto de nuestro Action Hub.
Lista de servicios integrados
En la siguiente lista se muestran los servicios disponibles en el Action Hub de Looker.
A continuación, te indicamos cómo usar la lista:
- Las URLs que se muestran en la columna Enlace al archivo README proporcionan instrucciones para habilitar y configurar el servicio integrado de forma que funcione con Looker.
- Las URLs que se muestran en la columna Cómo usar esta integración proporcionan instrucciones sobre cómo enviar datos de Looker al servicio integrado. Algunos de estos artículos también contienen instrucciones para habilitar la función.
- En Etiquetas de LookML obligatorias se indican las etiquetas que se deben usar con el parámetro
tagsen el modelo subyacente del contenido. - Tipo de acción: indica el nivel de datos que envía el servicio integrado (campo, consulta o panel de control). Una acción a nivel de campo envía el valor de una sola celda especificada de una tabla de datos. Una acción a nivel de consulta envía los resultados de una consulta completa, como todas las filas de un Exploración o un Look. Una acción a nivel de panel envía una imagen de un panel.
- Contenido disponible para envíos programados indica qué tipo de contenido de Looker puede enviar este servicio integrado como envío de contenido ad hoc o programado.
- Usa la autenticación OAuth de Google: indica si el servicio integrado usa las credenciales OAuth de Google para la autenticación. Es posible que las instancias alojadas por el cliente no puedan habilitar acciones del Action Hub de Looker que usen OAuth de Google. Consulte la página de documentación Compartir datos a través de un centro de acciones para ver las soluciones sugeridas a este posible problema.
- Usa la transmisión de datos: indica si el servicio integrado admite resultados de consultas transmitidos. Es posible que las instancias alojadas por el cliente no puedan habilitar acciones del Action Hub de Looker que transmitan resultados. Consulte la página de documentación Compartir datos a través de un centro de acciones para ver las soluciones sugeridas a este posible problema.
- Versión mínima compatible de Looker: indica la versión más antigua de Looker que debe usar tu instancia para poder usar esta integración.
| Servicio integrado | Descripción | Enlace al archivo README | Cómo usar esta integración | Etiquetas de LookML obligatorias | Tipo de acción | Contenido disponible para envíos programados | Usa la autenticación OAuth de Google (Sí/No) | Usa la transmisión de datos (Sí/No) | Versión mínima admitida de Looker |
|---|---|---|---|---|---|---|---|---|---|
| Airtable | Añadir registros a una tabla de Airtable. | Ver el archivo README en GitHub | Ver artículo de la comunidad | Ninguno | Consulta | Buscar y explorar | No | No | 5,6 |
| Amazon SageMaker Infer | Realiza una inferencia con Amazon SageMaker. | No hay ningún archivo README disponible | No hay ningún artículo disponible | Ninguno | Consulta | Buscar y explorar | No | Sí | 5,6 |
| Amazon SageMaker Train: Linear Learner | Inicia una tarea de entrenamiento en Amazon SageMaker con el algoritmo Linear Learner. | No hay ningún archivo README disponible | No hay ningún artículo disponible | Ninguno | Consulta | Buscar y explorar | No | Sí | 5,6 |
| Amazon SageMaker Train: Xgboost | Inicia una tarea de entrenamiento en Amazon SageMaker con el algoritmo Xgboost. | No hay ningún archivo README disponible | No hay ningún artículo disponible | Ninguno | Consulta | Buscar y explorar | No | Sí | 5,6 |
| Detener instancia de Amazon Web Services EC2 | Detener una instancia de EC2 mediante la API de Amazon EC2. | Ver el archivo README en GitHub | Ver artículo de la comunidad | aws_resource_id | Campo, consulta | Buscar y explorar | No | No | 5,6 |
| Barrena | Usa los resultados de la consulta para crear un modelo predictivo. | Ver el archivo README en GitHub | Consulta el archivo README | Ninguno | Consulta | Buscar y explorar | No | Sí | 5.24 |
| Azure Storage | Enviar y almacenar un archivo de datos en Azure Storage. | Ver el archivo README en GitHub | Ver artículo de la comunidad | Ninguno | Consulta, panel de control | Look, Explorar y panel de control | No | Sí (para consultas) o No (para paneles de control) | 5,6 |
| Braze | La acción de Braze te permite marcar usuarios en Braze mediante el endpoint de la API REST desde un Look. Asegúrate de que haya un campo braze_id etiquetado en los resultados. MAX EXPORT: 10000. |
Ver el archivo README en GitHub | Consulta el archivo README | braze_id | Consulta | Buscar y explorar | No | Sí | 5,6 |
| Logotipo de DataRobot | Envía datos a DataRobot y crea un proyecto. | Ver el archivo README en GitHub | Consulta el archivo README | Ninguno | Consulta | Buscar y explorar | No | Sí | 5.24 |
| DigitalOcean: detener Droplet | Detén el proceso de DigitalOcean mediante la API de DigitalOcean. | Ver el archivo README en GitHub | Ver artículo de la comunidad | digitalocean_droplet_id | Campo, consulta | Buscar y explorar | No | No | 5,6 |
| DigitalOcean Spaces | Enviar y almacenar un archivo de datos en DigitalOcean Storage. | Ver el archivo README en GitHub | Ver artículo de la comunidad | Ninguno | Consulta, panel de control | Look, Explorar y panel de control | No | Sí (en el caso de los Looks y las exploraciones), No (en el caso de los paneles de control) | 5,6 |
| Dropbox | Enviar y almacenar un archivo de datos en Dropbox. | No hay ningún archivo README disponible | Ver documentación | Ninguno | Consulta, panel de control | Look, Explorar y panel de control | Sí | No | 6.8 |
| Audiencias personalizadas de Facebook | Sube datos a audiencias personalizadas de Facebook Ads desde una lista de clientes. | Ver el archivo README en GitHub | Consulta el archivo README | Ninguno | Consulta | Buscar y explorar | Sí | Sí | 6.10 |
| Firebase | Usa Firebase para enviar notificaciones push a móviles. | No hay ningún archivo README disponible | No hay ningún artículo disponible | Ninguno | Consulta | Buscar y explorar | No | No | 22,4 |
| Segmentación por lista de clientes de Google Ads | Subir datos a la segmentación por lista de clientes de Google Ads. | Ver el archivo README en GitHub | Ver documentación | Ninguno | Consulta | Buscar y explorar | Sí | Sí | 6.10 |
| Importación de datos de Google Analytics | Subir datos a un conjunto de datos de Google Analytics. | Ver el archivo README en GitHub | Consulta el archivo README | Ninguno | Consulta | Buscar y explorar | Sí | Sí | 6.10 |
| Google Cloud Storage | Escribir archivos de datos en un segmento de Google Cloud Storage. | Ver el archivo README en GitHub | Ver artículo de la comunidad | Ninguno | Consulta, panel de control | Look, Explorar y panel de control | No | Sí (en el caso de los Looks y las exploraciones), No (en el caso de los paneles de control) | 5,6 |
| Google Drive | Enviar datos a Google Drive. | No hay ningún archivo README disponible | Ver documentación | Ninguno | Consulta, panel de control | Look, Explorar y panel de control | Sí | Sí (en el caso de los Looks y las exploraciones), No (en el caso de los paneles de control) | 7.4 |
| Hojas de cálculo de Google | Enviar datos CSV a una hoja de cálculo de Google. | No hay ningún archivo README disponible | Ver documentación | Ninguno | Consulta | Buscar y explorar | Sí | Sí | 7.4 |
| HubSpot Companies | Añade propiedades a tus empresas mediante la API V3 de HubSpot. | Ver el archivo README en GitHub | Consulta el archivo README | hubspot_company_id | Consulta | Buscar y explorar | No | Sí | 5,6 |
| Contactos de HubSpot | Añade propiedades a tus contactos mediante la API V3 de HubSpot. | Ver el archivo README en GitHub | Consulta el archivo README | hubspot_contact_id | Consulta | Buscar y explorar | No | Sí | 5,6 |
| Kloudio | Añadir datos a una hoja de cálculo de Google. | Ver el archivo README en GitHub | Consulta el archivo README | Ninguno | Consulta | Buscar y explorar | No | No | 5,6 |
| mParticle | Exporta en bloque tus datos de usuario o de evento de Looker a mParticle. | Ver el archivo README en GitHub | Consulta el archivo README | Consulta el archivo README | Consulta | Buscar y explorar | No | Sí | 5,6 |
| Campañas de Salesforce | Añade contactos o clientes potenciales a una campaña de Salesforce. | Ver el archivo README en GitHub | Consulta el archivo README | sfdc_contact_id o sfdc_lead_id | Consulta | Buscar y explorar | Sí | No | 22,6 |
| Grupo de segmentos | Añade características o usuarios a tus grupos de segmentos. | Ver el archivo README en GitHub | Ver documentación | segment_group_id y user_id, o segment_group_id y segment_anonymous_id | Consulta | Buscar y explorar | No | Sí | 4,20 |
| Segment Identify | Añade características a tus usuarios de Segment mediante Identify. | Ver el archivo README en GitHub | Ver documentación | email, user_id, segment_anonymous_id o segment_group_id | Consulta | Buscar y explorar | No | Sí | 4,20 |
| Pista de segmento | Conéctese a varias integraciones proporcionadas por Segment para identificar y segmentar a los usuarios en flujos de trabajo de marketing. | Ver el archivo README en GitHub | Ver documentación | email, user_id, segment_anonymous_id o segment_group_id | Consulta | Buscar y explorar | No | Sí | 4,20 |
| SendGrid | Envía datos y programa los resultados para que se envíen a una dirección de correo mediante la API de SendGrid. | Ver el archivo README en GitHub | Ver artículo de la comunidad | Ninguno | Consulta, panel de control | Look, Explorar y panel de control | No | No | 5,6 |
| Slack | Envía contenido de Looker en mensajes directos, canales públicos y canales privados de Slack mediante OAuth. Está disponible para las implementaciones alojadas en Looker con Looker 6.24 o una versión posterior y la función Lista de IPs permitidas inhabilitada. | No hay ningún archivo README disponible | Ver documentación | Ninguno | Consulta, panel de control | Look, Explorar y panel de control | Sí | Sí (en el caso de los Looks y las exploraciones), No (en el caso de los paneles de control) | 6,24 |
| Adjunto de Slack (token de API) | Envía datos directamente a un canal de Slack junto con las credenciales de usuario. También puedes consultar la documentación de Lookerbot para obtener más información sobre las funciones de Slack. | Ver el archivo README en GitHub | Ver documentación | Ninguno | Consulta, panel de control | Look, Explorar y panel de control | No | No | 5,6 |
| Teams: webhook entrante | Enviar datos a Microsoft Teams mediante un webhook entrante. | Ver el archivo README en GitHub | Consulta el archivo README | Ninguno | Consulta, panel de control | Look, Explorar y panel de control | No | No | 5,6 |
| Bandeja | Conéctate a varias integraciones proporcionadas por Tray.io para automatizar flujos de trabajo. | Ver el archivo README en GitHub | Ver artículo de la comunidad | Ninguno | Consulta | Buscar y explorar | No | Sí | 5,6 |
| Twilio: enviar datos | Envía datos de un Look o programa resultados para que se envíen a un número de teléfono mediante la API de Twilio. | Ver el archivo README en GitHub | Ver artículo de la comunidad | Ninguno | Consulta | Buscar y explorar | No | No | 5,6 |
| Twilio: enviar mensaje | Enviar un mensaje a una serie de números de teléfono (columnas de datos etiquetadas como números de teléfono) en un look. | Ver el archivo README en GitHub | Consulta el archivo README | teléfono | Campo, consulta | Buscar y explorar | No | No | 5,6 |
| Zapier | Conéctate a varias integraciones proporcionadas por Zapier para automatizar flujos de trabajo. | Ver el archivo README en GitHub | Ver artículo de la comunidad | Ninguno | Consulta | Buscar y explorar | No | Sí | 5,6 |
Más información
Para obtener más información, consulta la página de documentación Compartir datos a través de un centro de acciones.