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 GA) tiene varios cambios rotundos 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 admitir los extremos de la API 4.0 GA de Looker. Para obtener más información, consulta las Políticas de compatibilidad con APIs y SDKs 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 puedes esperar cuando migres a la API 4.0 GA.
¿Quién debería leer este artículo?
Este documento es para ti si usas la API de Looker a través de SDKs compatibles con Looker, SDKs compatibles con la comunidad o la propia API. 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. En ella, se describen los cambios rotundos y las mitigaciones disponibles cuando migras a la API 4.0 GA.
La API 4.0 GA 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} extremo muestra id como tipo string en lugar de tipo int64.
Lee la siguiente tabla para conocer el impacto y las mitigaciones específicos del uso del extremo de la API 4.0:
| Uso | Posible impacto1 | 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 para dispositivos móviles de Looker. |
| SDKs compatibles con Looker 2 | ||
| 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 compatibles con la comunidad2 | ||
| SDK de Swift | Excepciones del entorno 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 del entorno 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 de 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 guía adicional. |
1: Suponiendo patrones de uso comunes 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: Compatibilidad con la API y el SDK de Looker. Looker no admite oficialmente las bibliotecas compatibles con la comunidad.
Usuarios de la API 3.1
Si usas la API 3.1, lee esta sección. En ella, se describen 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. Consulta las políticas de compatibilidad con SDKs y APIs para obtener más información.
Funciones adicionales de la API 4.0 GA
Para tu comodidad, enumeramos los cambios aditivos más notables y útiles de la API 4.0:
- Creación y administració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 de la conexión, como bases de datos, esquemas, columnas y tablas. Configura y actualiza 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.
- Busca roles con recuento de usuarios.
- Obtén y configura los parámetros de configuración de la instancia de Looker (consulta la página de documentación de la 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 de las alertas para obtener más información sobre las alertas)
- Creación, administración y pruebas de túneles SSH y servidores SSH. (consulta la página de documentación de SSH para obtener más información sobre SSH)
- Mueve y copia paneles.
- Obtén URLs relativas para paneles nuevos.
- Mueve y copia Looks.
- Creación y administración de URLs, usuarios y secretos de incorporación firmados y no firmados
- Obtén el token de actualización para actualizar el token de acceso de acceso.
- Limita y desplaza los resultados de la obtención de 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 JSON de Swagger 2.x.
Cambios en la baja de la API 4.0 GA
La API 4.0 GA reemplaza varios extremos obsoletos de la API 3.1 con funciones mejoradas. Los siguientes extremos se ven afectados:
- Se quitaron los extremos obsoletos de la página principal. En su lugar, usa los extremos de la pizarra en lugar de las páginas principales. Consulta Presentar contenido con pizarras.
- Se quitaron los extremos obsoletos del espacio. Usa los extremos de la carpeta en lugar del 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 migres a la API 4.0.
- Solo la API 4.0 admite todos los SDKs compatibles con Looker y con la comunidad para facilitar tu desarrollo. Consulta nuestro repositorio de SDKs.
- La API 4.0 presenta varias funciones y mejoras nuevas, como se indica en la sección Funciones adicionales de la API 4.0 GA de esta página.
Conclusión
Puedes esperar que se agreguen funciones nuevas y cambios aditivos 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 la API. 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 4.0 de Looker de disponibilidad general te ayude a desarrollar de forma más productiva y sencilla en la plataforma de Looker.