Esta é a documentação do Looker. Para conferir a documentação do Looker Studio, acesse https://support.google.com/looker-studio.

Esta página foi traduzida pela API Cloud Translation.

Como fazer o download dos arquivos JAR do Looker

Para instalar ou atualizar o aplicativo Looker para uma implantação hospedada pelo cliente, faça o download dos arquivos JAR do Looker. Esta página descreve dois métodos para fazer o download de arquivos JAR do Looker:

Usar a página da Web Fazer o download do arquivo JAR do Looker
Como chamar a API

Antes de fazer o download dos arquivos JAR, aceite um Contrato de licença de usuário final (EULA), disponível na página da Web Fazer o download do arquivo JAR do Looker, com as especificações desta página. Cada usuário que fizer o download dos arquivos JAR precisa aceitar este EULA apenas uma vez. Se o EULA for atualizado no futuro, cada usuário também precisará aceitar a versão mais recente.

Na página da Web Fazer o download do arquivo JAR do Looker

Acesse a página da Web para fazer o download do arquivo JAR do Looker neste link: https://download.looker.com/validate. Para fazer o download dos arquivos JAR do Looker, siga estas etapas:

Insira o número da sua licença do Looker.
Digite seu endereço de e-mail. Precisa ser um domínio de e-mail hospedado de modo privado.
Selecione a versão do Looker para fazer o download.

Se você selecionar Versão mais recente, vai fazer o download da versão mais recente dos arquivos JAR do Looker para a versão atual do Looker. Se você selecionar Versão específica, insira exatamente o nome do arquivo JAR principal do Looker.

Observação: a convenção de nomenclatura dos arquivos JAR para cada versão inclui o ponto (.) no número da versão e segue um padrão definido. Por exemplo, os nomes de arquivo JAR do Looker 22.2 são looker-22.2.jar e looker-dependencies-22.2.jar.
Clique em Fazer o download.

Se você ainda não aceitou o EULA, um formulário de Aceitação do EULA vai aparecer. Selecione Ler os Termos e Condições para consultar o EULA na íntegra. Em seguida, insira seu Nome e Sobrenome e marque a caixa de seleção ao lado de Concordo com os Termos e Condições. Por fim, clique em Fazer o download.
Clique em Download 1 of 2 para fazer o download do arquivo JAR principal do Looker. Depois clique em Download 2 of 2 para salvar o arquivo JAR de dependências do Looker. O link expira em 10 minutos. Se o link expirar, você poderá reiniciar o processo de download.

Como chamar a API

Antes de fazer o download dos arquivos JAR chamando a API, aceite o EULA na página da Web Fazer o download do arquivo JAR do Looker.

Em seguida, você pode fazer a chamada de API necessária fazendo uma solicitação POST para o endpoint HTTPS com qualquer método desejado: JavaScript, Java, Ruby, comando shell etc. Para que qualquer uma dessas solicitações funcione, você precisa usar o método POST para enviar o payload da API para https://apidownload.looker.com/download. O payload da API precisa conter valores para lic, email e latest.

A propriedade latest indica a versão do JAR do Looker. Para fazer o download da versão mais recente dos arquivos JAR para a versão atual do Looker (looker-latest.jar), especificar "latest" é suficiente. Para fazer o download de uma versão específica, defina latest como "specific" e inclua outro par de chave-valor no payload da API, chamado specific, com o nome do arquivo JAR principal como o valor.

Você só precisa chamar a API uma vez. A resposta inicial conterá os dois links de download e estará disponível por um período de 10 minutos. Você precisará fazer o download de ambos os arquivos JAR separadamente.

Veja dois exemplos de como fazer uma solicitação escrita em ES6 (JavaScript). Para solicitar a versão mais recente:

    axios({
        url: "https://apidownload.looker.com/download",
        method: "post",
        data: {
            lic: "YOUR-LOOK-ERLI-CENS-EKEY",
            email: "contact@email.com",
            latest: "latest"
        }
    }).then(function (response) {
        console.log(response.data);
    })

Para solicitar uma versão específica do JAR (por exemplo, Looker 22.2): none data: { lic: "YOUR-LOOK-ERLI-CENS-EKEY", email: "contact@email.com", latest: "specific", specific: "looker-22.2-latest.jar" }

Veja dois exemplos de comandos do shell para fazer solicitações POST para o endpoint HTTPS.

Para solicitar uma versão específica de arquivos JAR usando o comando wget (por exemplo, Looker 22.2):

wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"

wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-dependencies-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"

Para solicitar os arquivos JAR mais recentes usando uma série de comandos curl e wget para fazer o download e salvar os arquivos localmente:

curl -X POST -H 'Content-Type: application/json' -d '{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"latest"}'
https://apidownload.looker.com/download > api_response.json
sed -i 1,12d api_response.json

wget -O "looker-latest.jar" "$(cat api_response.json | jq -r '.url')"

wget -O "looker-dependencies-latest.jar" "$(cat api_response.json | jq -r '.depUrl')"

Como alternativa, se você tiver o jq e o wget instalados, poderá usar os exemplos de comando de shell a seguir.

Para solicitar os arquivos JAR mais recentes usando uma série de comandos wget:

wget -O "looker-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .url -r)"

wget -O "looker-dependencies-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"

Você também pode fazer o download de outras versões do JAR definindo LOOKER_VERSION como latest, 22.2-latest ou outra versão compatível na série de exemplos de comando a seguir. Por exemplo, para solicitar os arquivos principais e de dependências do Looker 22.2:

export LOOKER_VERSION="22.2-latest"

wget -O "looker$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"specific\",\
\"specific\":\"looker-$(LOOKER_VERSION).jar\"} "https://apidownload.looker.com/download | jq .url -r)"

wget -O "looker-dependencies$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H\
'Content-Type: application/json' -d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\":\
\"$(contact@email.com)\",\"latest\":\"specific\", \"specific\":\"looker-dependencies-$(LOOKER_VERSION).jar\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"

Erros de carga útil da API, como parâmetros de entrada ausentes ou digitados incorretamente, resultam em uma resposta de "Corpo da solicitação inválido". Fornecer uma chave de licença incorreta ou omitir um valor specific ao solicitar uma versão do specific resultará em uma resposta "Solicitação inválida".

Problemas com o download de ambos os arquivos JAR podem resultar em uma mensagem no campo splitJarMessage.

Se você ainda não aceitou o EULA mais recente, a resposta terá três campos: eulaMessage, eulaText e eulaNeeded. O eulaMessage vai indicar que você precisa aceitar o EULA na página da Web Fazer o download do arquivo JAR do Looker antes que a API retorne um URL de download.