Temos o prazer de anunciar que a API Looker 4.0 está disponível para todos no Looker 22.4. A API 4.0 de disponibilidade geral (API 4.0 GA) tem várias mudanças interruptivas e aditivas e promove vários endpoints da versão Beta para a Estável. Confira nossa referência da API para ver as especificações detalhadas da API 4.0. Atualizamos nossos SDKs com suporte do Looker e da comunidade para oferecer suporte aos endpoints da API Looker 4.0 GA. Para mais informações, consulte Políticas de suporte a APIs e SDKs e Controle de versões da API. O restante deste artigo descreve as mudanças interruptivas, as mitigações e os recursos que você pode esperar ao migrar para a API 4.0 GA.
Para quem é este documento?
Este documento é para você se usar a API Looker por SDKs com suporte do Looker, SDKs com suporte da comunidade ou a própria API. Leia a seção a seguir que corresponde à versão da API Looker que você usa.
Usuários da API 4.0 pré-GA
Se você usa a API 4.0, leia esta seção. Ela aborda as mudanças interruptivas e as mitigações disponíveis ao migrar para a API 4.0 GA.
A API 4.0 GA inclui a mudança de todos os campos de ID da entidade do tipo numérico integer para o tipo string. Por exemplo, GET /groups/{group_id} endpoint retorna id como tipo string em vez de tipo int64.
Leia a tabela a seguir para conferir o impacto e as mitigações específicos do uso do endpoint da API 4.0:
| Uso | Possível impacto1 | Prevenção |
| Apps Looker para dispositivos móveis | Instalações desatualizadas de apps Looker para dispositivos móveis param de funcionar | Peça aos usuários para atualizar para a versão mais recente dos apps Looker para dispositivos móveis |
| SDKs com suporte do Looker2 | ||
| 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 execução | Atualize o SDK para a versão 22.0 ou mais recente 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 do C# | Sem impacto | Nenhuma ação é necessária |
| SDK do Go | Exceções de execução | Atualize o SDK para a versão 22.0 ou mais recente e resolva os erros de tipo resultantes, se houver |
| Outro | ||
| Usar a API 4.0 sem um SDK (ou com bibliotecas fornecidas externamente) | Possíveis erros de execução, dependendo da sensibilidade ao tipo de linguagem | Revise o código para dependências no tipo de campos de ID e adicione suporte a campos de ID do tipo string. Consulte também estas orientações adicionais. |
1: Considerando 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 a aplicação de operações numéricas a IDs.
2: Suporte a SDKs e APIs do Looker. As bibliotecas com suporte da comunidade não têm suporte oficial do Looker.
Usuários da API 3.1
Se você usa a API 3.1, leia esta seção. Ela aborda os recursos e mudanças adicionais que a API 4.0 disponibiliza para você. Todos os nossos SDKs com suporte do Looker e da comunidade oferecem suporte principalmente à API 4.0. Consulte as políticas de suporte a SDKs e APIs para mais informações.
Recursos adicionais da API 4.0 GA
Para sua conveniência, listamos as mudanças mais notáveis e úteis da API 4.0:
- Criação e gerenciamento de quadros, itens e seções de quadros. Consulte a página de documentação do quadro para mais informações.
- Consulte informações de conexão adicionais, como bancos de dados, esquemas, colunas e tabelas. Defina e atualize outros campos de conexão.
- Criação e gerenciamento de apps e usuários do OAuth. Consulte a página de documentação do OAuth para mais informações.
- Pesquise grupos com hierarquia e funções.
- Pesquise funções com contagem de usuários.
- Acesse 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 de documentação de 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.
- Mova e copie painéis.
- Receba URLs relativos para novos painéis.
- Mova e copie Looks.
- Criação e gerenciamento de URLs, usuários e chaves secretas de incorporação assinada e não assinada.
- Receba o token de atualização para atualizar o token de acesso de login.
- Limite e desloque os resultados da obtenção de todos os modelos LookML e todos os usuários.
- Limite e desloque os resultados da pesquisa de usuários.
- Receba a especificação da API da instância do Looker em JSON do Swagger 2.x.
Mudanças de descontinuação da API 4.0 GA
A API 4.0 GA substitui vários endpoints descontinuados da API 3.1 por recursos aprimorados. Os endpoints a seguir são afetados:
- Os endpoints descontinuados da página inicial foram removidos. Use os endpoints do quadro em vez das páginas iniciais. Consulte Apresentação de conteúdo com quadros.
- Os endpoints descontinuados do espaço foram removidos. Use endpoints de pastas em vez de espaços. Consulte Organizar e gerenciar o acesso ao conteúdo.
Usuários da API 3.0
A API 3.0 foi descontinuada. Recomendamos que você migre para a API 4.0.
- Somente a API 4.0 oferece suporte a todos os SDKs com suporte do Looker e da comunidade para facilitar o desenvolvimento. Confira nosso repositório de SDKs.
- A API 4.0 apresenta vários novos recursos e melhorias, conforme listado na seção Recursos adicionais da API 4.0 GA nesta página.
Conclusão
Você pode esperar novos recursos e mudanças aditivas a serem adicionados à API 4.0, e sempre pode encontrar as mudanças mais recentes na nossa referência da API. Para mais informações, consulte Políticas de suporte a APIs e SDKs e Controle de versões da API. Sabemos que as mudanças interruptivas não são ideais. A menos que surja um problema extremo, não faremos mudanças interruptivas na nossa API 4.0 de disponibilidade geral. Esperamos que a API Looker 4.0 de disponibilidade geral ajude você a desenvolver de forma mais produtiva e fácil na plataforma Looker.