Link rápido das Páginas Conectadas

Pré-lançamento: este recurso está sujeito aos Termos de Produtos e Recursos em Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Se você encontrar um problema durante o acesso antecipado da opção do menu de engrenagem Explorar ações das páginas conectadas, informe o problema para [e-mail].

Nesta página, descrevemos como ativar e usar a opção de link rápido das Páginas Conectadas no menu de engrenagem Ações de análise no Looker. A opção Páginas Conectadas abre o Google Planilhas e inicia uma conexão entre ele e a Análise 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 do Looker selecionada.

Antes de começar

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

• Uma instância do Looker que foi ativada e configurada para o recurso por um administrador, 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 permissão explore para os modelos do LookML que você quer conectar ao Planilhas.
• Uma Conta do Google com o mesmo endereço de e-mail associado à sua conta do Looker

Observação: esse recurso não está disponível para usuários do Looker incorporado.

Como usar o link rápido das Páginas Conectadas em uma Análise

Se o administrador do Looker tiver ativado o recurso, você poderá iniciar uma conexão entre o Google Planilhas e qualquer Análise 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, acesse a Análise que você quer usar como fonte de dados.

   Dica: não é necessário criar uma consulta na Análise. Você pode deixá-la em branco.

3. Clique no ícone de engrenagem Ações de análise 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 ser o mesmo associado à sua conta de usuário do Looker.

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

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

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

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

Como ativar e configurar o link rápido das Páginas Conectadas

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

• A instância precisa estar executando o Looker 25.20 ou uma versão mais recente.
• Para instâncias do Looker (Google Cloud Core), o link rápido das Páginas Conectadas só é compatível com conexões públicas seguras ou conexões de rede híbridas. As instâncias de conexões particulares (acesso a serviços particulares) do Looker (Google Cloud Core) não são compatíveis.
• Para instâncias do Looker (original), o link rápido das Páginas Conectadas só é compatível com instâncias hospedadas pelo Looker. As instâncias do Looker hospedadas pelo cliente não são compatíveis.

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

• Ative a API Google Sheets no console do Google Cloud .
• Crie um cliente OAuth no console do Google Cloud no mesmo projeto do console do Google Cloud em que a API Google Sheets foi ativada.
• Ative e configure a opção Ativar o link rápido das Páginas Conectadas na página "Conectores de BI do Looker".

Ativar a API Google Sheets no console do Google Cloud

O link rápido das Páginas Conectadas usa a API Google Sheets, que precisa estar ativada no mesmo projeto que você vai 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.

Siga estas etapas para ativar a API Google Sheets:

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

   Acessar a API Google Sheets

2. No console do Google Cloud , abra o seletor de projetos e selecione o projeto que você quer usar para se conectar ao Google Planilhas nas Análises do Looker. Use o mesmo projeto do console do Google Cloud 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.

É possível configurar o cliente OAuth em qualquer projeto do Google Cloud que você quiser. No entanto, a API Google Sheets precisa estar ativada nesse mesmo projeto.

Observação: antes de gerar suas credenciais OAuth, o Google exige que você configure uma tela de permissão OAuth, que permite que os usuários escolham como conceder acesso aos dados particulares deles. Se você ainda não configurou uma tela de permissão OAuth para o projeto do console do Google Cloud selecionado, o console do Google Cloud vai mostrar um aviso com o botão Configurar tela de permissão. Clique no botão e siga o procedimento na página de documentação do Workspace Configurar a tela de permissão OAuth e escolher escopos. Depois, volte para este procedimento.

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

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

   Acessar o console do Google Cloud

2. Use o menu principal do console do Google Cloud para acessar 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 vai aparecer. Essa janela mostra o ID do cliente e a chave secreta do cliente que o console do Google Cloud criou para seu cliente OAuth. Copie e anote esses valores, porque eles serão necessários quando você configurar a opção de link rápido para ativar as páginas conectadas.

Como configurar a opção de link rápido para ativar as Páginas Conectadas

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

1. Na instância do Looker, selecione Conectores de BI na seção Plataforma do painel Administrador.
2. Ative a opção Google Planilhas, se ainda não estiver ativada. Você também pode ativar o cliente pré-configurado das Páginas Conectadas na página Gerenciar clientes OAuth. As configurações entre as duas páginas são sincronizadas.
3. Ative a opção 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 console do Google Cloud quando criou o cliente OAuth no console do Google Cloud .
5. Clique em Salvar.

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

Como migrar do programa piloto

Se a organização tiver participado do programa piloto anterior do recurso Abrir no Planilhas, sua instância do Looker usou um cliente OAuth gerenciado de forma centralizada fornecido pelo Looker. Essa configuração está sendo descontinuada em favor do método mais seguro e escalonável, em que cada administrador do Looker configura o próprio cliente OAuth para a instância do Looker. Os clientes que já usam o piloto precisam fazer a transição para essa nova configuração para garantir a continuidade do funcionamento.

Para migrar para a nova versão, um administrador precisa configurar o cliente OAuth da sua organização no console do Google Cloud e, em seguida, configurar as credenciais na página Administrador do Looker BI Connectors. As etapas são as mesmas da primeira configuração, descritas nestas seções da página:

• Ativar a API Google Sheets no console do Google Cloud
• Crie um cliente OAuth no console do Google Cloud no mesmo projeto do console do Google Cloud em que a API Google Sheets foi ativada.
• Ative e configure a opção Ativar o link rápido das Páginas Conectadas na página "Conectores de BI do Looker"

Depois que um administrador concluir essas etapas, sua instância vai usar automaticamente o novo fluxo do 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 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 só vai aparecer no menu de engrenagem Ações de análise se o administrador do Looker tiver ativado o recurso nas configurações dos conectores de BI. Entre em contato com o admin do Looker para receber ajuda.
• Permissões do console doGoogle Cloud : o administrador que configura o cliente OAuth e a tela de permissão precisa ter as permissões roles/oauthconfig.editor e roles/serviceusage.serviceUsageAdmin no projeto do Google Cloud .
• Para outros problemas ou feedback durante o período de acesso antecipado, envie um e-mail para [e-mail].