API de Looker 4.0 disponible para el público general

Nos complace anunciar que la API de Looker 4.0 está disponible para el público en general en Looker 22.4. La API disponible de manera general 4.0 (GA 4.0 GA) tiene varios cambios aditivos y rotundos, y promueve varios extremos de la versión beta a la estable. Las API 3.1 y 3.0 no se ven afectadas. Consulta nuestra referencia de la API para obtener especificaciones detalladas de la API 4.0. Actualizamos nuestros SDK compatibles con Looker y la Comunidad para admitir los extremos de Google Analytics 4.0 de la API de Looker. Para obtener más información, consulte las Políticas de asistencia de la API y el SDK y el Control de versiones de la API. En el resto de este artículo, se describen los cambios rotundos, las mitigaciones y las funciones que puede esperar cuando migre a la API 4.0.

¿Quién debería leerlo?

Este documento es para ti si usas la API de Looker mediante SDK y SDK compatibles con la Comunidad o de la API en sí. Lee la siguiente sección relacionada con la versión de la API de Looker que usas actualmente.

Usuarios de la API de fase previa a la DG 4.0

Si usas la API 4.0, lee esta sección. Abarca los cambios rotundos y las mitigaciones disponibles cuando migras a la API 4.0 de Google Analytics en Looker 22.4.

La API 4.0 de Google Analytics incluye el cambio de todos los campos de ID de entidad del tipo integer numérico a tipo string. Por ejemplo, el extremo de GET /groups/{group_id} muestra id como el tipo string, en lugar del tipo int64.

Lee la siguiente tabla para conocer el impacto y las mitigaciones específicas del uso de tu extremo de la API 4.0:

Uso	Impacto potencial¹	Prevención

Apps para dispositivos móviles de Looker	Las instalaciones desactualizadas de las apps para dispositivos móviles de Looker dejan de funcionar	Hacer que los usuarios actualicen la aplicación a los dispositivos móviles de Looker a la versión más reciente
SDK compatibles con Looker²
SDK de TypeScript (API 4.0)	No hubo impacto.	No se requiere ninguna acción
SDK de Python (API 4.0)	No hubo impacto.	No se requiere ninguna acción
SDK de Ruby (API 4.0)	No hubo impacto.	No se requiere ninguna acción
SDK compatibles con la comunidad²
SDK de Swift	Excepciones del entorno de ejecución	Actualiza el SDK a la versión 22.0 (o una posterior) y, luego, resuelve los errores de tipo resultantes, si corresponde.
SDK de Kotlin	No hubo impacto.	No se requiere ninguna acción
SDK de Lookr	No hubo impacto.	No se requiere ninguna acción
SDK de C#	No hubo impacto.	No se requiere ninguna acción
SDK de Go	Excepciones del entorno de ejecución	Actualiza el SDK a la versión 22.0 (o una posterior) y, luego, resuelve los errores de tipo resultantes, si corresponde.
Otros
Uso de la API 4.0 sin un SDK (o con bibliotecas externas)	Posibles errores de tiempo de ejecución, según la sensibilidad del tipo de lenguaje	Revisa el código de las dependencias con respecto al tipo de cualquier campo de ID y agrega compatibilidad con los campos de ID de tipo string. Consulta también esta guía adicional.

1: Suponer patrones de uso comunes que pueden incluir el uso de campos de ID de Looker, pero no patrones de uso inusuales, como aplicar operaciones numéricas a los ID.

2: Compatibilidad con la API y el SDK de Looker. Looker no admite oficialmente las bibliotecas con asistencia de la comunidad.

Usuarios de la API 3.1

Si usas la API 3.1, lee esta sección. Abarca las funciones adicionales y los cambios que la API 4.0 pone a tu disposición. Ten en cuenta que todos nuestros SDK compatibles con Looker y la comunidad son compatibles principalmente con la API 4.0. Consulta las políticas de compatibilidad de SDK y API para obtener más información.

Características adicionales de la API de GA 4.0

Para mayor comodidad, enumeramos los cambios adicionales y más útiles aditivos a la API 4.0:

Creación y administración de secciones, elementos y placas en la pizarra La documentación de la Junta se encuentra aquí.
Consulta la información de conexión adicional, como bases de datos, esquemas, columnas y tablas. Establece y actualiza campos de conexión adicionales.
Creación y administración de usuarios y apps de OAuth La documentación de OAuth está aquí.
Busque grupos con jerarquía y funciones.
Funciones de búsqueda con cantidad de usuarios.
Obtener y establecer la configuración de la instancia de Looker La documentación de configuración se encuentra aquí.
Creación y administración de alertas. La documentación sobre las alertas se encuentra aquí.
Creación, administración y prueba de túneles SSH y de servidores SSH. La documentación de SSH está aquí.
Mover y copiar paneles
Obtén URLs relativas para paneles nuevos.
Estilos Mover y Copiar
SSO y el secreto de incorporación de SSO, la URL y la creación y administración de usuarios
Obtén el token de actualización para actualizar el token de acceso de acceso.
Limita y compensa los resultados para obtener todos los modelos de LookML y todos los usuarios.
Limitar y compensar los resultados de la búsqueda de usuarios
Obtén la especificación de la API de la instancia de Looker en JSON de Swagger 2.x.

Cambios en la baja de la API de Google Analytics 4.0

La versión 4.0 de Google Analytics reemplaza varios extremos obsoletos de la API 3.1 por funciones mejoradas. A continuación, se muestran los extremos afectados:

Se quitaron los extremos obsoletos de la página principal. Usa los extremos de la pizarra en lugar de las páginas principales. Consulta Cómo presentar contenido con pizarras.
Se quitaron los extremos obsoletos del espacio. Usa extremos de carpeta en lugar de Espacio. Consulta Organización y administración del acceso al contenido.

Usuarios de la API 3.0

La API 3.0 está obsoleta y te recomendamos que la migres a la API 4.0.

Solo la API 4.0 es compatible con todos los SDK compatibles con Looker y la comunidad para facilitar tu desarrollo. Consulta nuestro repositorio de SDK.
La API 4.0 presenta varias mejoras y funciones nuevas, tal como se mencionó anteriormente.

Conclusión

Puede esperar nuevas funciones y cambios aditivos para agregar a la API 4.0. Siempre puede encontrar los cambios más recientes en nuestra referencia de la API. Para obtener más información, consulte las Políticas de asistencia de la API y el SDK y el Control de versiones de la API. Sabemos que los cambios rotundos no son los ideales. A menos que surja un problema extremo, no realizaremos cambios rotundos en nuestra API de disponibilidad general 4.0. Esperamos que nuestra API de Looker 4.0 esté disponible de manera general para ayudarte a desarrollar de forma más productiva y sencilla en la plataforma de Looker.