Nos complace anunciar que la API de Looker 4.0 está disponible de forma general en Looker 22.4. La API 4.0 de disponibilidad general (API 4.0 DG) tiene varios cambios intercalados y aditivos, y promueve varios extremos de Beta a Estable. Consulta nuestra referencia de la API para obtener especificaciones detalladas de la API 4.0. Actualizamos nuestros SDKs compatibles con Looker y con la comunidad para que admitan los extremos de la versión GA de la API de Looker 4.0. Para obtener más información, consulta las políticas de compatibilidad con APIs y SDKs y el control de versiones de APIs. En el resto de este artículo, se describen los cambios rotundos, las mitigaciones y las funciones que puedes esperar cuando migres a la versión de disponibilidad general de la API 4.0.
¿Quién debería leer este documento?
Este documento es para ti si usas la API de Looker a través de los SDKs compatibles con Looker, los SDKs compatibles con la comunidad o la API en sí. Lee la siguiente sección que se asigna a la versión de la API de Looker que usas.
Usuarios de la API 4.0 previa a la DG
Si usas la API 4.0, lee esta sección. Abarca los cambios rotundos y las mitigaciones disponibles cuando migras a la versión GA de la API 4.0.
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, el extremo GET /groups/{group_id} devuelve id como tipo string en lugar de tipo int64.
Consulta la siguiente tabla para conocer el impacto y las mitigaciones específicos del uso de tu extremo de la API 4.0:
| Uso | Impacto potencial1 | Prevención |
| Apps para dispositivos móviles de Looker | Las instalaciones desactualizadas de las apps para dispositivos móviles de Looker dejan de funcionar | Pídeles a los usuarios que actualicen a la versión más reciente de las apps de Looker para dispositivos móviles |
| SDKs compatibles con Looker2 | ||
| 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 |
| 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 posterior y, luego, resuelve los errores de tipo resultantes, si los hay. |
| 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 de tiempo de ejecución | Actualiza el SDK a la versión 22.0 o posterior y, luego, resuelve los errores de tipo resultantes, si los hay. |
| Otro | ||
| Uso de 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 detectar dependencias en el tipo de cualquier campo de ID y agrega compatibilidad con los campos de ID de tipo cadena. También revisa esta orientación adicional. |
1: Se suponen patrones de uso comunes que pueden incluir el uso de los campos de ID de Looker, pero no patrones de uso inusuales, como la aplicación de operaciones numéricas a los IDs.
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 y los cambios adicionales que la API 4.0 pone a tu disposición. Ten en cuenta que todos nuestros 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 compatibilidad con SDKs y APIs.
Funciones adicionales de la DG de la API 4.0
Para tu comodidad, enumeramos los cambios más notables y útiles de la API 4.0:
- Creación y administración de tableros, elementos de tableros y secciones de tableros Consulta la página de documentación de los tableros para obtener más información sobre ellos.
- Consultar información de conexión adicional, como bases de datos, esquemas, columnas y tablas Configurar y actualizar campos de conexión adicionales
- Creación y administración de usuarios y apps de OAuth Consulta la página de documentación de OAuth para obtener más información sobre OAuth.
- Busca grupos con jerarquía y roles.
- Buscar roles con recuento de usuarios
- Obtener y establecer la configuración de la instancia de Looker Consulta la página de documentación de Configuración para obtener más información sobre la configuración.
- Creación y administración de alertas Consulta la página de documentación sobre las alertas para obtener más información.
- Creación, administración y prueba de túneles y servidores SSH Consulta la página de documentación sobre SSH para obtener más información sobre SSH.
- Mover y copiar paneles
- Obtén URLs relativas para los paneles nuevos.
- Mover y copiar Looks
- Incorporación firmada y secreto de incorporación no firmado, URL, y creación y administración de usuarios
- Obtén 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 la búsqueda de usuarios.
- Obtén la especificación de la API de la instancia de Looker en formato JSON de Swagger 2.x.
Cambios en la baja de la DG de la API 4.0
La versión GA de la API 4.0 reemplaza varios extremos de la API 3.1 que quedaron obsoletos con funciones mejoradas. Los siguientes extremos se verán afectados:
- Se quitaron los extremos de la página principal que estaban en desuso. En su lugar, usa los endpoints de los tableros en lugar de las páginas principales. Consulta Cómo presentar contenido con pizarras.
- Se quitaron los extremos de Space obsoletos. Usa endpoints de carpetas en lugar de espacios. Consulta Organización y administración del 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 SDK compatibles con Looker y con la comunidad para facilitar tu desarrollo. Consulta nuestro repositorio del SDK.
- La API 4.0 introduce varias funciones y mejoras nuevas, como se indica en la sección Funciones adicionales de la DG de la API 4.0 de esta página.
Conclusión
Puedes esperar nuevas funciones y cambios aditivos que se agregarán a la API 4.0, y siempre puedes encontrar los cambios más recientes en nuestra referencia de la API. Para obtener más información, consulta las políticas de compatibilidad con APIs y SDKs y el control de versiones de APIs. Sabemos que los cambios rotundos no son ideales. A menos que surja un problema extremo, no realizaremos ningún cambio rotundo en nuestra API 4.0 de disponibilidad general. Esperamos que nuestra API de Looker 4.0 disponible de forma general te ayude a desarrollar de manera más productiva y sencilla en la plataforma de Looker.