Link rápido das Páginas Conectadas

Pré-lançamento:esse recurso está sujeito aos "Termos das Soluções 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 Ações de análise detalhada 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 Páginas conectadas no menu de engrenagem Ações de análise do Looker. A opção Páginas conectadas abre o Google Planilhas e inicia uma conexão entre o app e a análise detalhada do Looker. Em seguida, você pode criar relatórios, tabelas dinâmicas ou gráficos na planilha Google recém-criada usando os campos da análise detalhada do Looker selecionada.

Antes de começar

Para usar o link rápido Planilhas Google Conectadas, você precisa do seguinte:

• Uma instância do Looker 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 LookML que você quer conectar às 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 de incorporação do Looker.

Usar o link rápido das páginas conectadas em uma análise detalhada

Se o administrador do Looker ativou o recurso, você pode iniciar uma conexão entre as 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, acesse a Análise que você quer usar como fonte de dados.

   Dica: não é necessário criar uma consulta na análise detalhada. Você pode deixar a análise em branco.

3. Clique no ícone de engrenagem Abrir ações 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. Analise as permissões solicitadas na tela de consentimento e clique em Permitir.

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

A planilha Google agora está conectada à Análise do Looker de onde você começou. Na planilha Google, é possível 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 Usar 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 Páginas Conectadas no menu de engrenagem Ações de análise detalhada, sua instância do Looker precisa atender aos seguintes requisitos:

• Sua 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 Planilhas Google Conectadas é compatível apenas com conexões de rede públicas seguras ou 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 Páginas conectadas só é compatível com instâncias hospedadas pelo Looker. Não há suporte para instâncias do Looker hospedadas pelo cliente.

Para ativar a opção Planilhas Google Conectadas no menu de engrenagem Ações da análise detalhada 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 Google Cloud .
• Crie um cliente OAuth no Google Cloud console no mesmo projeto do Google Cloud console 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 Google Cloud

O link rápido Planilhas Google 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 do IAM.

Siga estas etapas para ativar a API Google Sheets:

1. No menu de navegação do console 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 , clique em Abrir seletor de projetos e escolha o projeto que você quer usar para se conectar ao Google Planilhas nas análises detalhadas do Looker. Use o mesmo projeto do console durante todo o procedimento de configuração do link rápido das Planilhas Google para que a API Google Sheets seja ativada no mesmo projeto em que você configura o OAuth. Google Cloud

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 as funções necessárias precisa criar um cliente OAuth.

É possível configurar o cliente OAuth em qualquer projeto Google Cloud . 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 aos usuários escolher como conceder acesso aos dados particulares deles. Se você ainda não tiver configurado uma tela de permissão OAuth para o projeto do console Google Cloud selecionado, o console Google Cloud vai mostrar um aviso com um 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, retorne a 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 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 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 e a chave secreta do cliente que o Google Cloud console 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 "Ativar o Google Planilhas Conectadas".

Como configurar a opção "Ativar o link rápido das Páginas Conectadas"

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

1. Na sua instância do Looker, selecione Conectores de BI na seção Plataforma do painel Administrador.
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 console Google Cloud ao criar o cliente OAuth no console Google Cloud .
5. Clique em Salvar.

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

Migração do programa piloto

Se sua organização participou do programa piloto anterior do recurso Abrir no 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 administrador do Looker configura o próprio cliente OAuth para a instância do Looker. Os clientes do piloto precisam migrar para essa nova configuração para garantir a funcionalidade contínua.

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

• Ative a API Google Sheets no console Google Cloud .
• Crie um cliente OAuth no Google Cloud console no mesmo projeto do Google Cloud console 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 do piloto anterior e a dependência dela no 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"Planilhas Google Conectadas" não está visível:essa opção só aparece no menu de engrenagem Ações do recurso Detalhes 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 consoleGoogle Cloud :o administrador que configura o cliente OAuth e a tela de consentimento precisa ter as permissões roles/oauthconfig.editor e roles/serviceusage.serviceUsageAdmin no projeto Google Cloud .
• Para outros problemas ou feedback durante o período de acesso antecipado, envie um e-mail para [e-mail].