A API Action do Looker permite que os programadores definam ações ou destinos personalizados para os quais o Looker pode enviar resultados de consultas, resultados de painéis de controlo ou interações do utilizador.
Depois de desenvolver uma ação, implementá-la como um serviço Web e, em seguida, adicioná-la a uma instância do Looker, os utilizadores do Looker podem enviar dados através dessa ação a partir do Looker.
Usar ações
A API Action suporta várias variações nos exemplos de utilização:
- As ações suportam vários níveis de interatividade do utilizador. Podem ser concebidos para interações de utilizadores ad hoc enquanto um utilizador está a ver um painel de controlo ou podem destinar-se a funcionar com agendamentos recorrentes ou acionados.
- As ações podem dar instruções ao Looker para recolher dados de formulários dos utilizadores, de modo a parametrizar o tratamento dos dados.
- As ações podem até pedir a autenticação do utilizador num serviço de terceiros através do OAuth, por exemplo, para fornecer dados implicitamente a destinos específicos do utilizador.
- As ações também podem receber resultados de consultas em vários formatos, desde formatos orientados para dados, como CSV e Excel, a vários formatos JSON para exemplos de utilização programáticos, até formatos orientados para visualização, como PNG ou PDF.
Embora estes exemplos de utilização sejam diversos, o denominador comum entre eles é que os utilizadores do Looker podem dar instruções ao Looker para entrar em contacto e enviar dados para uma ação.
Como resultado, a implementação de uma ação envolve a implementação de um serviço Web para ouvir estes pedidos.
Isto pode ser conseguido adicionando alguns novos pontos finais a um servidor de aplicações existente, implementando um servidor Web exclusivamente para este fim ou até mesmo usando um ambiente sem servidor, como as funções do Google Cloud Run. A API Actions não exige que o serviço mantenha qualquer estado entre pedidos, pelo que os servidores de ações podem beneficiar de configurações de implementação sem estado escaláveis e flexíveis.
Por último, uma vez que a API Actions consiste em pedidos HTTP POST formatados em JSON, qualquer linguagem do lado do servidor pode ser facilmente usada para implementar uma ação. O Looker oferece vários exemplos em TypeScript, incluindo o código de código aberto para o nosso Action Hub.
Lista de serviços integrados
A lista seguinte mostra os serviços disponíveis no Action Hub do Looker.
Veja como usar a lista:
- Os URLs apresentados na coluna Link to README file (Link para o ficheiro README) fornecem instruções para ativar e configurar o serviço integrado para funcionar com o Looker.
- Os URLs apresentados na coluna Como usar esta integração fornecem instruções sobre como enviar dados do Looker para o serviço integrado. Alguns destes artigos também contêm instruções de ativação.
- Etiquetas LookML obrigatórias apresenta todas as etiquetas obrigatórias que têm de ser usadas com o parâmetro
tagsno modelo subjacente do conteúdo. - O Tipo de ação indica o nível de dados que o serviço integrado está a enviar: campo, consulta ou painel de controlo. Uma ação ao nível do campo envia o valor de uma única célula especificada numa tabela de dados. Uma ação ao nível da consulta envia os resultados de uma consulta completa, como todas as linhas num Explore ou num Look. Uma ação ao nível do painel de controlo envia uma imagem de um painel de controlo.
- Conteúdo disponível para envios agendados indica o tipo de conteúdo do Looker que este serviço integrado pode enviar como um envio de conteúdo ad hoc ou agendado.
- Usa a autenticação OAuth da Google indica se o serviço integrado usa credenciais OAuth da Google para autenticação. As instâncias alojadas pelo cliente podem não conseguir ativar ações do Looker Action Hub que usam o Google OAuth. Consulte a página de documentação Partilhar dados através de um centro de ações para ver soluções sugeridas para este potencial problema.
- Usa streaming de dados indica se o serviço integrado suporta resultados de consultas transmitidos por streaming. As instâncias alojadas pelo cliente podem não conseguir ativar ações do Action Hub do Looker que transmitem resultados. Consulte a página de documentação Partilhar dados através de um centro de ações para ver soluções sugeridas para este potencial problema.
- A versão mínima suportada do Looker indica a versão mais antiga do Looker que a sua instância tem de estar a usar para poder usar esta integração.
| Serviço integrado | Descrição | Link para o ficheiro README | Como usar esta integração | Etiquetas LookML obrigatórias | Tipo de ação | Conteúdo disponível para envios agendados | Usa a autenticação OAuth da Google (sim/não) | Usa streaming de dados (sim/não) | Versão mínima suportada do Looker |
|---|---|---|---|---|---|---|---|---|---|
| Airtable | Adicione registos a uma tabela no Airtable. | Ver README no GitHub | Ver artigo da comunidade | Nenhum | Consulta | Procure e explore | Não | Não | 5,6 |
| Amazon SageMaker Infer | Realize uma inferência com o Amazon SageMaker. | Nenhum LEIA-ME disponível | Nenhum artigo disponível | Nenhum | Consulta | Procure e explore | Não | Sim | 5,6 |
| Amazon SageMaker Train: Linear Learner | Inicie uma tarefa de preparação no Amazon SageMaker, usando o algoritmo Linear Learner. | Nenhum LEIA-ME disponível | Nenhum artigo disponível | Nenhum | Consulta | Procure e explore | Não | Sim | 5,6 |
| Amazon SageMaker Train: Xgboost | Inicie uma tarefa de preparação no Amazon SageMaker, usando o algoritmo Xgboost. | Nenhum LEIA-ME disponível | Nenhum artigo disponível | Nenhum | Consulta | Procure e explore | Não | Sim | 5,6 |
| Amazon Web Services EC2 Stop Instance | Pare uma instância do EC2 através da API Amazon EC2. | Ver README no GitHub | Ver artigo da comunidade | aws_resource_id | Campo, consulta | Procure e explore | Não | Não | 5,6 |
| Broca | Use o resultado da consulta para criar um modelo preditivo. | Ver README no GitHub | Ver README | Nenhum | Consulta | Procure e explore | Não | Sim | 5,24 |
| Armazenamento do Azure | Enviar e armazenar um ficheiro de dados no Azure Storage. | Ver README no GitHub | Ver artigo da comunidade | Nenhum | Consulta, painel de controlo | Pesquisar, explorar, painel de controlo | Não | Sim (para consultas), não (para painéis de controlo) | 5,6 |
| Braze | A ação do Braze permite-lhe sinalizar utilizadores no Braze através do ponto final da API REST a partir de um Look. Certifique-se de que existe um campo braze_id etiquetado nos resultados. MAX EXPORT: 10000. |
Ver README no GitHub | Ver README | braze_id | Consulta | Procure e explore | Não | Sim | 5,6 |
| DataRobot | Envie dados para o DataRobot e crie um novo projeto. | Ver README no GitHub | Ver README | Nenhum | Consulta | Procure e explore | Não | Sim | 5,24 |
| DigitalOcean: parar Droplet | Pare o processo do DigitalOcean através da API DigitalOcean. | Ver README no GitHub | Ver artigo da comunidade | digitalocean_droplet_id | Campo, consulta | Procure e explore | Não | Não | 5,6 |
| DigitalOcean Spaces | Enviar e armazenar um ficheiro de dados no DigitalOcean Storage. | Ver README no GitHub | Ver artigo da comunidade | Nenhum | Consulta, painel de controlo | Pesquisar, explorar, painel de controlo | Não | Sim (para Looks e explorações), não (para painéis de controlo) | 5,6 |
| Dropbox | Envie e armazene um ficheiro de dados no Dropbox. | Nenhum LEIA-ME disponível | Veja a documentação | Nenhum | Consulta, painel de controlo | Pesquisar, explorar, painel de controlo | Sim | Não | 6.8 |
| Públicos-alvo personalizados do Facebook | Carregue dados para públicos-alvo personalizados do Facebook Ads a partir da lista de clientes. | Ver README no GitHub | Ver README | Nenhum | Consulta | Procure e explore | Sim | Sim | 6.10 |
| Firebase | Use o Firebase para enviar notificações push para dispositivos móveis. | Nenhum LEIA-ME disponível | Nenhum artigo disponível | Nenhum | Consulta | Procure e explore | Não | Não | 22,4 |
| Segmentação por lista de clientes do Google Ads | Carregue dados para a Segmentação por lista de clientes do Google Ads. | Ver README no GitHub | Veja a documentação | Nenhum | Consulta | Procure e explore | Sim | Sim | 6.10 |
| Importação de dados do Google Analytics | Carregue dados para um conjunto de dados do Google Analytics. | Ver README no GitHub | Ver README | Nenhum | Consulta | Procure e explore | Sim | Sim | 6.10 |
| Google Cloud Storage | Escrever ficheiros de dados num contentor do Google Cloud Storage. | Ver README no GitHub | Ver artigo da comunidade | Nenhum | Consulta, painel de controlo | Pesquisar, explorar, painel de controlo | Não | Sim (para Looks e explorações), não (para painéis de controlo) | 5,6 |
| Google Drive | Envie dados para o Google Drive. | Nenhum LEIA-ME disponível | Veja a documentação | Nenhum | Consulta, painel de controlo | Pesquisar, explorar, painel de controlo | Sim | Sim (para Looks e explorações), não (para painéis de controlo) | 7.4 |
| Google Sheets | Enviar dados CSV para uma folha de cálculo do Google Sheets. | Nenhum LEIA-ME disponível | Veja a documentação | Nenhum | Consulta | Procure e explore | Sim | Sim | 7.4 |
| Empresas do Hubspot | Adicione propriedades às suas empresas através da API V3 do Hubspot. | Ver README no GitHub | Ver README | hubspot_company_id | Consulta | Procure e explore | Não | Sim | 5,6 |
| Contactos do Hubspot | Adicione propriedades aos seus contactos através da API V3 do Hubspot. | Ver README no GitHub | Ver README | hubspot_contact_id | Consulta | Procure e explore | Não | Sim | 5,6 |
| Kloudio | Adicione dados a uma Folha de cálculo do Google Sheets. | Ver README no GitHub | Ver README | Nenhum | Consulta | Procure e explore | Não | Não | 5,6 |
| mParticle | Exporte em massa os seus dados de utilizadores ou eventos do Looker para o mParticle. | Ver README no GitHub | Ver README | Ver README | Consulta | Procure e explore | Não | Sim | 5,6 |
| Campanhas do Salesforce | Adicionar contactos ou leads à campanha do Salesforce. | Ver README no GitHub | Ver README | sfdc_contact_id ou sfdc_lead_id | Consulta | Procure e explore | Sim | Não | 22,6 |
| Grupo de segmentos | Adicione atributos e/ou utilizadores aos seus grupos de segmentos. | Ver README no GitHub | Veja a documentação | segment_group_id e user_id, ou segment_group_id e segment_anonymous_id | Consulta | Procure e explore | Não | Sim | 4,20 |
| Segment Identify | Adicione caraterísticas aos seus utilizadores do Segment através da funcionalidade Identify. | Ver README no GitHub | Veja a documentação | email ou user_id ou segment_anonymous_id ou segment_group_id | Consulta | Procure e explore | Não | Sim | 4,20 |
| Faixa de segmentos | Estabeleça ligação a várias integrações fornecidas pelo Segment para identificar e segmentar utilizadores para fluxos de trabalho de marketing. | Ver README no GitHub | Veja a documentação | email ou user_id ou segment_anonymous_id ou segment_group_id | Consulta | Procure e explore | Não | Sim | 4,20 |
| SendGrid | Envie dados e agende o envio de resultados para um endereço de email através da API do SendGrid. | Ver README no GitHub | Ver artigo da comunidade | Nenhum | Consulta, painel de controlo | Pesquisar, explorar, painel de controlo | Não | Não | 5,6 |
| Slack | Enviar conteúdo do Looker em mensagens diretas, canais públicos e canais privados no Slack através do OAuth. Está disponível para implementações alojadas no Looker no Looker 6.24 ou superior com a funcionalidade Lista de autorizações de IPs desativada. | Nenhum LEIA-ME disponível | Veja a documentação | Nenhum | Consulta, painel de controlo | Pesquisar, explorar, painel de controlo | Sim | Sim (para Looks e explorações), não (para painéis de controlo) | 6,24 |
| Anexo do Slack (chave da API) | Enviar dados diretamente para um canal do Slack juntamente com as credenciais do utilizador. Também pode consultar a documentação do Lookerbot para ver funcionalidades adicionais do Slack. | Ver README no GitHub | Veja a documentação | Nenhum | Consulta, painel de controlo | Pesquisar, explorar, painel de controlo | Não | Não | 5,6 |
| Teams: webhook recebido | Envie dados para o Microsoft Teams através de um webhook recebido. | Ver README no GitHub | Ver README | Nenhum | Consulta, painel de controlo | Pesquisar, explorar, painel de controlo | Não | Não | 5,6 |
| Tabuleiro | Estabeleça ligação a várias integrações fornecidas pela Tray.io para automatizar fluxos de trabalho. | Ver README no GitHub | Ver artigo da comunidade | Nenhum | Consulta | Procure e explore | Não | Sim | 5,6 |
| Twilio — Enviar dados | Enviar dados de uma análise detalhada ou agendar resultados para envio para um número de telefone através da API da Twilio. | Ver README no GitHub | Ver artigo da comunidade | Nenhum | Consulta | Procure e explore | Não | Não | 5,6 |
| Twilio: enviar mensagem | Envie uma mensagem para uma série de números de telefone (colunas de dados etiquetadas como números de telefone) num Look. | Ver README no GitHub | Ver README | telemóvel | Campo, consulta | Procure e explore | Não | Não | 5,6 |
| Zapier | Associe-se a várias integrações fornecidas pela Zapier para automatizar fluxos de trabalho. | Ver README no GitHub | Ver artigo da comunidade | Nenhum | Consulta | Procure e explore | Não | Sim | 5,6 |
Para obter mais informações
Para mais informações, consulte a página de documentação Partilhar dados através de um centro de ações.