Nos complace anunciar que la API de Looker 4.0 está disponible para el público en general en Looker 22.4. La API 4.0 de disponibilidad general (API 4.0 DG) tiene varios cambios rotundos y adicionales, y promueve varios endpoints de Beta a estable. Consulta nuestra referencia de la API para conocer las especificaciones detalladas de la API 4.0. Actualizamos nuestros SDK compatibles con Looker y la comunidad para admitir los extremos de DG de la API de Looker 4.0. Si deseas obtener más información, consulta las Políticas de compatibilidad de las APIs y los SDKs y el Control de versiones de las 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 API 4.0 de DG.
¿Quién debería leer esto?
Este documento es para ti si usas la API de Looker mediante 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 actualmente.
Usuarios de la API 4.0 de la DG 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 API 4.0 de DG.
La DG de la API 4.0 incluye cambiar todos los campos de ID de entidad del tipo numérico integer
al tipo string
. Por ejemplo, el extremo de GET /groups/{group_id}
muestra id
como el tipo string
en lugar de el tipo int64
.
Lee la siguiente tabla para conocer el impacto y las mitigaciones específicas de tu uso de extremos de la API 4.0:
Uso | Impacto potencial1 | Prevención |
Apps para dispositivos móviles de Looker | Las instalaciones desactualizadas de las apps de Looker para dispositivos móviles dejarán de funcionar | Haz que los usuarios actualicen a la versión más reciente de las apps de Looker para dispositivos móviles |
SDKs compatibles con 2 de 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 |
SDKs 2 compatibles con la comunidad | ||
SDK de Swift | Excepciones de tiempo de ejecución | Actualiza el SDK a la versión 22.0 o posterior y resuelve los errores de tipo resultantes, si los hubiera. |
SDK de Kotlin | No hubo impacto. | No se requiere ninguna acción |
SDK de Looker | 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 resuelve los errores de tipo resultantes, si los hubiera. |
Otros | ||
Con una API 4.0 sin un SDK (o con bibliotecas proporcionadas de forma externa) | Posibles errores de entorno de ejecución, según la sensibilidad de tipo del lenguaje | Revisa el código en busca de dependencias para el tipo de cualquier campo de ID y agrega compatibilidad con campos de ID de tipo string. Consulta también esta orientación adicional. |
1: Suponiendo que existen patrones de uso comunes que pueden incluir el uso de los campos de ID de Looker, pero no de patrones de uso inusuales, como aplicar operaciones numéricas a los IDs.
2: Compatibilidad con la API y el SDK de Looker. Las bibliotecas con asistencia de la comunidad no son compatibles oficialmente con Looker.
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 SDK compatibles con Looker y la comunidad son compatibles principalmente con la API 4.0. Consulta las Políticas de compatibilidad del SDK y la API para obtener más información.
Funciones adicionales de DG de la API 4.0
Para mayor comodidad, te mostramos los cambios adicionales más notables y útiles de la API 4.0:
- Creación y administración de las secciones de tablero, elemento de tablero y tablero. Consulta la página de Documentación de la placa para obtener más información sobre las placas.
- Consulta información de conexión adicional, como bases de datos, esquemas, columnas y tablas. Configura y actualiza campos de conexión adicionales.
- Creación y administración de apps y usuarios de OAuth. Consulta la página de documentación de OAuth para obtener más información sobre OAuth.
- Buscar grupos con jerarquía y roles.
- Funciones de búsqueda con recuento de usuarios.
- Obtén y establece 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 de alertas para obtener más información sobre las alertas.
- Creación, administración y prueba de túneles 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.
- Mover y copiar vistas.
- Incorporación firmada y Secreto de incorporación, URL y creación y administración de usuarios
- Obtén un token de actualización para actualizar el token de acceso de acceso.
- Limitar y compensar los resultados de obtener todos los modelos de LookML y todos los usuarios
- Limita y compensa los resultados de los usuarios que realizan búsquedas.
- Obtén las especificaciones de la API de la instancia de Looker en Swagger 2.x JSON.
Cambios en la baja de DG de la API 4.0
La versión de DG de la API 4.0 reemplaza varios extremos de la API 3.1 obsoletos con funciones mejoradas. Enumeramos los endpoints afectados a continuación:
- Se quitaron los extremos de la página principal que ya no estaban disponibles. Usa los extremos de la placa en lugar de las páginas principales. Consulta Presenta contenido con tableros.
- Se quitaron los extremos del espacio obsoletos. Usa extremos de la carpeta en lugar del espacio. Consulta Organizar y administrar 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.
- Para facilitar tu desarrollo, solo la API 4.0 es compatible con todos los SDKs que admite Looker y la comunidad. Consulta el repositorio del SDK.
- La API 4.0 incluye varias funciones y mejoras nuevas, como se indica en la sección adicionales de funciones de DG de la API 4.0 en esta página.
Conclusión
Puedes esperar que se agreguen nuevas funciones y cambios adicionales a la API 4.0 y podrás encontrar los cambios más recientes en nuestra referencia de la API. Si deseas obtener más información, consulta las Políticas de compatibilidad de las APIs y los SDKs y el Control de versiones de las APIs. Sabemos que los cambios rotundos no son ideales. A menos que surja un problema extremo, no realizaremos cambios rotundos en nuestra API 4.0 de disponibilidad general. Esperamos que la API 4.0 de Looker disponible de forma general te ayude a desarrollar de manera más productiva y sencilla en la plataforma de Looker.