Esta página foi traduzida pela API Cloud Translation.

Disponibilidade geral da API Looker 4.0

Temos o prazer de anunciar que a API Looker 4.0 está disponível para todos os usuários no Looker 22.4. A API 4.0 de disponibilidade geral (API 4.0 GA) tem várias mudanças importantes e incrementais e promove vários endpoints de Beta para 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 as políticas de suporte a APIs e SDKs e o Controle de versões da API. O restante deste artigo descreve as mudanças importantes, mitigações e recursos que você pode esperar ao migrar para a API 4.0 GA.

Quem deve ler este artigo?

Este documento é para você se você usa a API Looker com SDKs compatíveis com o Looker, SDKs compatíveis com a 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. Ele aborda as mudanças interruptivas e as mitigações disponíveis ao migrar para a API 4.0 GA.

A API 4.0 do GA inclui a alteração de todos os campos de ID da entidade do tipo integer numérico 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 saber sobre o impacto e as mitigações específicas do uso do endpoint da API 4.0:

Uso	Possível impacto¹	Prevenção

Apps Looker para dispositivos móveis	Instalações desatualizadas de apps para dispositivos móveis do Looker param de funcionar	Peça para os usuários atualizarem para a versão mais recente dos apps Looker para dispositivos móveis
SDKs com suporte ao 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 Ruby (API 4.0)	Sem impacto	Nenhuma ação é necessária
SDKs com suporte da comunidade²
SDK do Swift	Exceções de execução	Atualize o SDK para a v22.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 C#	Sem impacto	Nenhuma ação é necessária
Go SDK	Exceções de execução	Atualize o SDK para a v22.0 ou mais recente e resolva os erros de tipo resultantes, se houver.
Outro
Como usar a API 4.0 sem um SDK (ou com bibliotecas fornecidas externamente)	Possíveis erros de execução, dependendo da sensibilidade do tipo de linguagem	Analise o código em busca de dependências do tipo de campos de ID e adicione suporte a campos de ID do tipo string. Confira também estas orientações.

1: Supõe 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 em IDs.

2: Suporte à API e ao SDK 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. Ele aborda os recursos e mudanças adicionais que a API 4.0 disponibiliza. Todos os 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.

Outros recursos do GA da API 4.0

Para sua conveniência, listamos as mudanças mais notáveis e úteis da API 4.0:

Criação e gerenciamento de seções, itens e painéis. Consulte a página de documentação sobre as placas para mais informações.
Consultar outras 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 e usuários OAuth. Consulte a página de documentação do OAuth para mais informações.
Pesquise 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 de 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, URL, criação e gerenciamento de usuários e chave secreta de incorporação.
Receber o token de atualização para atualizar o token de acesso de login.
Limite e compense os resultados de todos os modelos do LookML e todos os usuários.
Limite e compense os resultados dos usuários que pesquisam.
Acesse a especificação da API de instância do Looker no JSON do Swagger 2.x.

Mudanças na descontinuação da API 4.0 do GA

A API 4.0 GA substitui vários endpoints descontinuados da API 3.1 com recursos aprimorados. Os endpoints a seguir são afetados:

Os endpoints descontinuados da página inicial foram removidos. Use endpoints de placa em vez de páginas iniciais. Consulte Apresentação de conteúdo com quadros.
Os endpoints descontinuados do Space 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, e é recomendável migrar 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 do SDK.
A API 4.0 apresenta vários novos recursos e melhorias, conforme listados na seção "Recursos adicionais da API 4.0 GA" desta página.

Conclusão

Novos recursos e mudanças adicionais serão adicionados à API 4.0. Você pode conferir 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 o Controle de versões da API. Sabemos que as mudanças não são ideais. A menos que um problema extremo ocorra, não faremos mudanças interruptivas na API 4.0 disponível para todos os usuários. Esperamos que a API Looker 4.0, disponível para todos, ajude você a desenvolver com mais produtividade e facilidade na plataforma Looker.