Nos complace anunciar que la API Looker 4.0 está disponible de forma general en Looker 22.4. La API 4.0 de disponibilidad general (API 4.0 GA) presenta varios cambios que suponen un punto de ruptura y otros que añaden funciones, y promueve varios endpoints de la versión beta a la estable. Consulta nuestra referencia de la API para ver las especificaciones detalladas de la API 4.0. Hemos actualizado nuestros SDKs compatibles con Looker y con la comunidad para que admitan los endpoints de la versión GA de la API Looker 4.0. Para obtener más información, consulta las políticas de asistencia de APIs y SDKs y el control de versiones de las APIs. En el resto de este artículo se describen los cambios incompatibles, las mitigaciones y las funciones que puedes esperar al migrar a la versión GA de la API 4.0.
¿A quién va dirigida esta información?
Este documento está dirigido a los usuarios que utilizan la API de Looker a través de los SDKs compatibles con Looker, los SDKs compatibles con la comunidad o la propia API. Consulta la sección siguiente, que se corresponde con la versión de la API de Looker que usas.
Usuarios de la API 4.0 previa a la disponibilidad general
Si usas la API 4.0, lee esta sección. En ella se describen los cambios incompatibles y las mitigaciones disponibles al migrar a la versión 4.0 de la API GA.
La versión GA de la API 4.0 incluye el cambio de todos los campos de ID de entidad del tipo numérico integer al tipo string. Por ejemplo, GET /groups/{group_id} endpoint devuelve id como tipo string en lugar de tipo int64.
Consulta la siguiente tabla para ver el impacto y las mitigaciones específicos del uso de tu endpoint de la API 4.0:
| Uso | Posible impacto1 | Prevención |
| Aplicaciones móviles de Looker | Las instalaciones obsoletas de las aplicaciones móviles de Looker dejan de funcionar | Pedir a los usuarios que actualicen a la versión más reciente de la aplicación móvil de Looker |
| SDKs compatibles con Looker2 | ||
| SDK de TypeScript (API 4.0) | Sin impacto | No hace falta hacer nada |
| SDK de Python (API 4.0) | Sin impacto | No hace falta hacer nada |
| SDK de Ruby (API 4.0) | Sin impacto | No hace falta hacer nada |
| SDKs con asistencia de la comunidad2 | ||
| SDK de Swift | Excepciones de tiempo de ejecución | Actualiza el SDK a la versión 22.0 o a una posterior y, a continuación, resuelve los errores de tipo que se produzcan. |
| SDK de Kotlin | Sin impacto | No hace falta hacer nada |
| SDK de Lookr | Sin impacto | No hace falta hacer nada |
| SDK de C# | Sin impacto | No hace falta hacer nada |
| SDK de Go | Excepciones de tiempo de ejecución | Actualiza el SDK a la versión 22.0 o a una posterior y, a continuación, resuelve los errores de tipo que se produzcan. |
| Otros | ||
| Usar la API 4.0 sin un SDK (o con bibliotecas proporcionadas externamente) | Posibles errores de tiempo de ejecución, según la sensibilidad al tipo del lenguaje | Revisa el código para comprobar si hay dependencias en el tipo de los campos de ID y añade compatibilidad con los campos de ID de tipo cadena. Consulta también estas directrices adicionales. |
1: Suponiendo patrones de uso habituales que pueden incluir el uso de los campos de ID de Looker, pero no patrones de uso inusuales, como aplicar operaciones numéricas a los IDs.
2: Asistencia para la API y el SDK de Looker. Looker no ofrece asistencia oficial para las bibliotecas con asistencia de la comunidad.
Usuarios de la API 3.1
Si usas la API 3.1, lee esta sección. En él se explican las funciones y los cambios adicionales que la API 4.0 pone a tu disposición. Ten en cuenta que todos los SDKs compatibles con Looker y con la comunidad admiten principalmente la API 4.0. Para obtener más información, consulta las políticas de asistencia para SDKs y APIs.
Funciones adicionales de la API 4.0 GA
Para tu comodidad, hemos incluido los cambios más notables y útiles de la API 4.0:
- Creación y gestión de pizarras, elementos de pizarra y secciones de pizarra. Consulta la página de documentación de la pizarra para obtener más información sobre las pizarras.
- Consulta información adicional sobre la conexión, como bases de datos, esquemas, columnas y tablas. Define y actualiza campos de conexión adicionales.
- Creación y gestión de aplicaciones y usuarios de OAuth. Para obtener más información sobre OAuth, consulta la página de documentación de OAuth.
- Buscar grupos con jerarquía y roles.
- Buscar roles por número de usuarios.
- Obtener y definir la configuración de la instancia de Looker. Consulta la página de documentación sobre los ajustes para obtener más información sobre los ajustes.
- Creación y gestión de alertas. Para obtener más información sobre las alertas, consulta la página de documentación sobre alertas.
- Creación, gestión y prueba de túneles y servidores SSH. Consulta más información sobre SSH en la página de documentación de SSH.
- Mover y copiar paneles de control.
- Obtener URLs relativas para los nuevos paneles de control
- Mover y copiar looks.
- Inserción firmada y creación y gestión de secretos, URLs y usuarios de inserción no firmada.
- Obtener un token de actualización para actualizar el token de acceso de inicio de sesión.
- Limita y desplaza los resultados para obtener todos los modelos de LookML y todos los usuarios.
- Limita y desplaza los resultados de 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 desactivación de la versión 4.0 de la API
La versión 4.0 de la API de GA sustituye varios endpoints de la versión 3.1 de la API, que están obsoletos, por funciones mejoradas. Los siguientes endpoints se verán afectados:
- Se han eliminado los endpoints de la página principal obsoletos. Usa los endpoints de la pizarra en lugar de las páginas principales. Consulta Presentar contenido con pizarras.
- Se han eliminado los endpoints de espacios obsoletos. Usa endpoints de carpetas en lugar de espacios. Consulta Organizar y gestionar el acceso al contenido.
Usuarios de la API 3.0
La API 3.0 está obsoleta, por lo que te recomendamos que migres a la API 4.0.
- Solo la API 4.0 admite todos los SDKs compatibles con Looker y con la comunidad para facilitar el desarrollo. Consulta nuestro repositorio del SDK.
- La API 4.0 incluye varias funciones y mejoras nuevas, como se indica en la sección Funciones adicionales de la API 4.0 de esta página.
Resumen
En la versión 4.0 de la API se añadirán nuevas funciones y cambios, y siempre podrás consultar las últimas novedades en nuestra referencia de la API. Para obtener más información, consulta las políticas de asistencia de APIs y SDKs y el control de versiones de las APIs. Sabemos que los cambios incompatibles no son lo ideal. A menos que surja un problema grave, no haremos ningún cambio incompatible en nuestra API 4.0, que está disponible para todos los usuarios. Esperamos que la API de Looker 4.0, que ya está disponible, te ayude a desarrollar de forma más productiva y sencilla en la plataforma Looker.