Temos o prazer de anunciar que a API Looker 4.0 está com disponibilidade geral no Looker 22.4. A API 4.0 (API 4.0 GA) disponível de forma geral tem várias alterações interruptivas e aditivas e promove vários endpoints de Beta para estável. Confira nossa referência de API para especificações detalhadas da API 4.0. Atualizamos nossos SDKs com suporte do Looker e da comunidade para oferecer suporte aos endpoints da versão GA da API Looker 4.0. Para mais informações, consulte as Políticas de suporte a APIs e SDKs e Controle de versões de APIs. O restante deste artigo descreve as alterações interruptivas, as mitigações e os recursos que você pode esperar ao migrar para a API 4.0 GA.
Quem deve ler isto?
Este documento é para você se você usa a API Looker usando SDKs com suporte do Looker, SDKs com suporte da comunidade ou a própria API. Leia a seção a seguir que mapeia para a versão da API Looker que você usa.
Usuários da API pré-GA 4.0
Se você usa a API 4.0, leia esta seção. Ele aborda as alterações interruptivas e as mitigações disponíveis quando você migra para a API 4.0 GA.
A API 4.0 GA inclui a alteração de todos os campos de ID da entidade do tipo numérico integer para o tipo string. Por exemplo, o endpoint GET /groups/{group_id} retorna id como o tipo string em vez do tipo int64.
Leia a tabela a seguir para ver o impacto e as mitigações específicas para o uso de endpoints da API 4.0:
| Uso | Possível impacto1 | Prevenção |
| Apps para dispositivos móveis Looker | As instalações obsoletas dos apps Looker para dispositivos móveis param de funcionar | Peça para os usuários atualizarem para a versão mais recente dos apps Looker para dispositivos móveis. |
| SDKs compatíveis com o2 Looker | ||
| SDK do TypeScript (API 4.0) | Sem impacto | Nenhuma ação é necessária |
| SDK do Python (API 4.0) | Sem impacto | Nenhuma ação é necessária |
| SDK do Ruby (API 4.0) | Sem impacto | Nenhuma ação é necessária |
| SDKs com suporte da comunidade2 | ||
| SDK do Swift | Exceções de tempo de execução | Atualize o SDK para a versão v22.0+ e resolva os erros de tipo resultantes, se houver |
| SDK do Kotlin | Sem impacto | Nenhuma ação é necessária |
| SDK do LookR | Sem impacto | Nenhuma ação é necessária |
| SDK para C# | Sem impacto | Nenhuma ação é necessária |
| Go SDK | Exceções de tempo de execução | Atualize o SDK para a versão v22.0+ e resolva os erros de tipo resultantes, se houver |
| Outros | ||
| Como usar a API 4.0 sem um SDK (ou com bibliotecas fornecidas externamente) | Possíveis erros de tempo de execução, dependendo da sensibilidade de tipo da linguagem | Revise o código em busca de dependências do tipo de qualquer campo de ID e adicione suporte para campos de ID do tipo string. Leia também estas orientações adicionais. |
1: Presumir padrões de uso comuns, que podem incluir o uso de campos de ID do Looker, mas não padrões de uso incomuns, como aplicação de operações numéricas a IDs.
2: Suporte à API Looker e ao SDK. As bibliotecas com suporte da comunidade não são oficialmente compatíveis com o Looker.
Usuários da API 3.1
Se você usa a API 3.1, leia esta seção. Ele abrange os recursos e alterações adicionais que a API 4.0 disponibiliza para você. Todos os nossos SDKs com suporte do Looker e da comunidade oferecem suporte à API 4.0. Consulte as políticas de suporte de SDKs e APIs para mais informações.
Outros recursos da API 4.0 GA
Para facilitar, listamos as mudanças aditivos da API 4.0 mais importantes e úteis para você:
- Criação e gerenciamento de Conselhos, itens e seções do quadro. Consulte a página de documentação da placa para mais informações sobre placas.
- Consulte mais informações de conexão, como bancos de dados, esquemas, colunas e tabelas. Defina e atualize outros campos de conexão.
- Criação e gerenciamento de apps OAuth e de usuários. Consulte a página de documentação do OAuth para mais informações.
- Pesquisar grupos com hierarquia e papéis.
- Pesquisar funções com contagem de usuários.
- Receba e defina as configurações da instância do Looker. Consulte a página de documentação de configurações para mais informações.
- Criação e gerenciamento de alertas. Consulte a página da documentação sobre alertas para mais informações.
- Criação, gerenciamento e teste de túneis e servidores SSH. Consulte a página de documentação do SSH para mais informações.
- Mover e copiar painéis.
- Receba URLs relativos para novos painéis.
- Mover e copiar Looks.
- Incorporação assinada e não assinada, além de URL, criação e gerenciamento de usuários.
- Receba o token de atualização para atualizar o token de acesso de login.
- Limite e desloque os resultados do recebimento de todos os modelos do LookML e todos os usuários.
- Limite e desloque os resultados da pesquisa de usuários.
- Acesse a especificação da API da instância do Looker no JSON do Swagger 2.x (em inglês).
Alterações de descontinuação da API 4.0 GA
A API 4.0 GA substitui vários endpoints da API 3.1 descontinuados por recursos aprimorados. Estes endpoints foram afetados:
- Os endpoints descontinuados da página inicial foram removidos. Use endpoints de board em vez de páginas iniciais. Consulte Apresentação de conteúdo com boards.
- Os endpoints descontinuados do Space foram removidos. Use endpoints de pasta em vez de espaço. Consulte Como organizar e gerenciar o acesso ao conteúdo.
Usuários da API 3.0
A API 3.0 foi descontinuada, e é recomendável migrar para a API 4.0.
- Para facilitar o desenvolvimento, somente a API 4.0 oferece suporte a todos os SDKs com suporte do Looker e da comunidade. Confira nosso repositório de SDKs.
- A API 4.0 apresenta vários novos recursos e melhorias, conforme listado na seção "Outros recursos do GA da API 4.0" nesta página.
Conclusão
Você já pode conferir os novos recursos e outras mudanças da API 4.0. Confira as mudanças mais recentes na nossa Referência da API. Para mais informações, consulte as Políticas de suporte a APIs e SDKs e Controle de versões de APIs. Sabemos que alterações interruptivas não são o ideal. A menos que surja um problema extremo, não faremos alterações interruptivas na API 4.0, disponível de maneira geral. Esperamos que nossa API Looker 4.0, disponível ao público geral, ajude você a desenvolver de maneira mais produtiva e fácil na plataforma Looker.