Link rápido das Páginas Conectadas

Nesta página, descrevemos como ativar e usar a opção de link rápido Páginas conectadas no menu de engrenagem Ações de análise detalhada no Looker. A opção Páginas conectadas abre o Planilhas Google e inicia uma conexão do Planilhas Google com a análise detalhada do Looker. Em seguida, você pode criar relatórios, tabelas dinâmicas ou gráficos na planilha do Google recém-criada usando os campos da análise detalhada do Looker selecionada.

Antes de começar

Para usar o link rápido Páginas conectadas, você precisa do seguinte:

  • Uma instância do Looker que foi ativada e configurada para o recurso por um admin, conforme descrito na seção Ativar e configurar o link rápido das páginas conectadas nesta página.
  • Uma conta de usuário do Looker com a explore permissão para os modelos LookML que você quer conectar às Planilhas.
  • Uma Conta do Google com o mesmo endereço de e-mail associado à sua conta do Looker.

Se o admin do Looker tiver ativado o recurso, você poderá iniciar uma conexão entre o Planilhas Google e qualquer análise detalhada a que tiver acesso:

  1. Faça login no Looker com o endereço de e-mail associado à sua Conta do Google.

  2. No Looker, navegue até a análise detalhada que você quer usar como fonte de dados.

  3. Clique no ícone de engrenagem Ações de análise detalhada e selecione Páginas conectadas.

  4. Na primeira vez que você usar esse recurso, será necessário autorizar o Looker a acessar sua Conta do Google. Escolha a Conta do Google que você quer usar. O endereço de e-mail da Conta do Google precisa corresponder ao endereço de e-mail associado à sua conta de usuário do Looker.

  5. Analise as permissões solicitadas na tela de permissão e clique em Permitir.

  6. Uma nova guia do navegador é aberta no Planilhas Google e apresenta uma caixa de diálogo perguntando se você quer vincular sua Conta do Google à sua conta do Looker. Clique em Vincular conta.

A planilha do Google agora está conectada à análise detalhada do Looker em que você começou. Na planilha do Google, você pode adicionar campos da análise detalhada, criar tabelas dinâmicas, criar gráficos e aplicar fórmulas para analisar os dados da análise detalhada do Looker.

Consulte a página da documentação Usar as páginas conectadas para o Looker para mais informações sobre como criar consultas nas páginas conectadas.

Ativar e configurar o link rápido das páginas conectadas

Para ativar o link rápido Páginas conectadas no menu de engrenagem Ações de análise detalhada, sua instância do Looker precisa atender aos seguintes requisitos:

Para ativar a opção Páginas conectadas no menu de engrenagem Ações de análise detalhada em uma instância do Looker, um admin precisa realizar estas tarefas gerais, que são descritas nas seções a seguir:

Ativar a API Google Sheets no Google Cloud console do

O link rápido Páginas conectadas usa a API Google Sheets. Portanto, essa API precisa estar ativada no mesmo projeto que você usará para criar o cliente OAuth. A API Google Sheets pode ser ativada por um usuário do IAM com a permissão roles/serviceusage.serviceUsageAdmin do IAM.

Siga estas etapas para ativar a API Google Sheets:

  1. No Google Cloud menu de navegação do console, acesse APIs e serviços > Biblioteca e abra a API Google Sheets.

    Acessar a API Google Sheets

  2. No Google Cloud console do Seletor de projetos aberto, selecione o projeto que você quer usar para se conectar ao Planilhas Google nas análises detalhadas do Looker. Você precisa usar o mesmo Google Cloud projeto do console durante todo o procedimento de configuração do link rápido das páginas conectadas para que a API Google Sheets seja ativada no mesmo projeto em que você configura o OAuth.

  3. Na página da API Google Sheets, clique em Ativar se a API ainda não estiver ativada.

Criar o cliente OAuth

Um usuário do IAM com os papéis necessários precisa criar um cliente OAuth.

Você pode configurar o cliente OAuth em qualquer Google Cloud projeto que quiser. No entanto, a API Google Sheets precisa estar ativada nesse mesmo projeto.

Para criar o cliente e as credenciais, siga estas etapas:

  1. No Google Cloud console, use o Google Cloud console Seletor de projetos aberto para abrir o mesmo projeto em que você ativou a API Google Sheets.

    Acessar o Google Cloud console

  2. Use o Google Cloud menu principal do console para navegar até APIs e serviços > Credenciais.

  3. Na página Credenciais , clique no menu suspenso Criar credenciais e selecione ID do cliente OAuth.

  4. No menu suspenso Tipo de aplicativo, selecione Aplicativo da Web.

  5. No campo Nome, insira um nome para o cliente OAuth, como Looker to Connected Sheets.

  6. Na seção URIs de redirecionamento autorizados, clique no botão Adicionar URI. Adicione o seguinte URI:

    https://LOOKER_INSTANCE_URL/oauth2callback

  7. Clique no botão Adicionar URI para adicionar também o seguinte URI:

    https://LOOKER_INSTANCE_URL/external_oauth/redirect

  8. Clique em Criar.

  9. Depois de clicar em Criar, uma janela Cliente OAuth criado aparece. Essa janela mostra o ID e a chave secreta do cliente que o Google Cloud console criou para o cliente OAuth. Copie e anote esses valores, porque eles serão necessários ao configurar a opção Ativar o link rápido das páginas conectadas.

Configurar a opção Ativar o link rápido das páginas conectadas

Depois de ativar a API Google Sheets no Google Cloud console e criar o cliente OAuth no Google Cloud console, você pode ativar o link rápido Páginas conectadas na instância do Looker seguindo estas etapas:

  1. Na instância do Looker, selecione Conectores de BI na seção Plataforma do painel Admin.
  2. Ative a opção Google Sheets se ela ainda não estiver ativada.
  3. Ative a opção aninhada Ativar o link rápido das páginas conectadas.
  4. Nos campos ID do cliente e Chave secreta do cliente, cole os valores que você copiou do Google Cloud console do ao criar o cliente OAuth no Google Cloud console do.
  5. Clique em Salvar.

A opção Páginas conectadas no menu de engrenagem Ações de análise detalhada agora está configurada para sua instância do Looker.

Migrar do programa piloto

Se sua organização participou do programa piloto anterior para o recurso Abrir nas Planilhas, a instância do Looker usou um cliente OAuth gerenciado centralmente fornecido pelo Looker. Essa configuração está sendo descontinuada em favor do método mais seguro e escalonável em que cada admin do Looker configura o próprio cliente OAuth para a instância do Looker. Os clientes piloto atuais precisam fazer a transição para essa nova configuração para garantir a funcionalidade contínua.

Para migrar para a nova versão, um admin precisa configurar o próprio cliente OAuth da organização no Google Cloud console e, em seguida, configurar as credenciais na página de admin dos conectores de BI do Looker. As etapas são as mesmas da configuração inicial, que são descritas nestas seções desta página:

Depois que um admin concluir essas etapas, a instância vai usar automaticamente o novo fluxo OAuth gerenciado pelo cliente. A funcionalidade piloto anterior e a dependência do cliente OAuth gerenciado pelo Looker não estarão mais ativas.

Solução de problemas

  • Erro de incompatibilidade de e-mail:se você encontrar um erro durante a etapa de autenticação do Google, verifique se a Conta do Google selecionada tem exatamente o mesmo endereço de e-mail da sua conta de usuário do Looker.
  • "A opção "Páginas conectadas" não está visível": essa opção vai aparecer no menu de engrenagem Ações de análise detalhada somente se o admin do Looker tiver ativado o recurso nas configurações dos conectores de BI. Entre em contato com o admin do Looker para receber ajuda.
  • Google Cloud Permissões do console do: o admin que configura o cliente OAuth e a tela de permissão precisa ter as permissões roles/oauthconfig.editor e roles/serviceusage.serviceUsageAdmin no Google Cloud projeto.
  • Para outros problemas ou feedback durante o período de prévia pública, envie um e-mail para looker-connected-sheets-external@google.com.