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 aditivos y de ruptura, y promueve varios extremos de la versión beta a la 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 versión GA de la API de 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 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 GA de la API 4.0.
¿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 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 de Fase Previa a la DG 4.0
Si usas la API 4.0, lee esta sección. Se abordan los cambios rotundos y las mitigaciones disponibles cuando migras a la DG 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}
muestra id
como tipo string
en lugar de tipo int64
.
Consulta la siguiente tabla para conocer los impactos y las mitigaciones específicos del uso del extremo de la API 4.0:
Uso | Impacto potencial1 | Prevención |
Apps para dispositivos móviles de Looker | Las instalaciones desactualizadas de apps para dispositivos móviles de Looker dejan de funcionar | Haz que los usuarios actualicen a la versión más reciente de las apps para dispositivos móviles de Looker |
SDKs de 2 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 |
SDKs2 admitidos por la comunidad | ||
SDK de Swift | Excepciones del tiempo de ejecución | Actualizar el SDK a la versión 22.0 (y versiones posteriores) y, luego, resolver los errores de tipo resultantes, si los |
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 una posterior y, luego, resuelve los errores de tipo resultantes, si los hay. |
Otro | ||
Usar la API 4.0 sin un SDK (o con bibliotecas proporcionadas de forma externa) | Posibles errores de entorno de ejecución, según la sensibilidad del tipo de lenguaje | Revisa el código para detectar dependencias sobre el tipo de cualquier campo de ID y agrega compatibilidad con los campos de ID de tipo de cadena. Revisa también esta orientación adicional. |
1: Se supone que se siguen 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: API de Looker y Compatibilidad con el SDK. Looker no ofrece compatibilidad oficial con las bibliotecas comunitarias.
Usuarios de la API 3.1
Si usas la API 3.1, lee esta sección. Abarca las características 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 la comunidad son compatibles principalmente con la API 4.0. Para obtener más información, consulta las políticas de compatibilidad de SDK y API.
Funciones adicionales de disponibilidad general de la API 4.0
Para tu comodidad, enumeramos los cambios más notables y útiles de la API 4.0 de Additive:
- Creación y administración de las secciones del tablero, los elementos de la junta y la junta. 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, schemas, 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.
- Busca grupos con jerarquía y roles.
- Busca roles con el recuento de usuarios.
- Obtener y establecer la configuración de instancias 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 ellas.
- 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.
- Mover y copiar paneles
- Obtén URLs relativas para paneles nuevos.
- Mover y copiar vistas.
- 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.
- Limita y compensa los resultados de obtener todos los modelos de LookML y todos los usuarios.
- Limita y compensa los resultados de la búsqueda de usuarios.
- Obtén las especificaciones de la API de la instancia de Looker en JSON de Swagger 2.x.
Cambios en la baja de la disponibilidad general de la API 4.0
La disponibilidad general de la API 4.0 reemplaza varios extremos de la API 3.1 que dejaron de estar disponibles por funciones mejoradas. Los siguientes extremos se ven afectados:
- Se quitaron los extremos obsoletos de la página principal. Usa los extremos del tablero en lugar de páginas principales. Consulta Cómo presentar contenido en tableros.
- Se quitaron los extremos obsoletos del espacio. Usa los extremos de las carpetas en lugar del espacio. Consulta Organiza y administra el acceso al contenido.
Usuarios de la API 3.0
La API 3.0 está obsoleta y se recomienda que migres a la API 4.0.
- Solo la API 4.0 admite todos los SDKs que admiten Looker y la comunidad para facilitar tu desarrollo. Consulta nuestro repositorio de SDK.
- La API 4.0 incluye varias funciones y mejoras nuevas, tal como se indica en la sección Funciones adicionales de Google Analytics para 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 asistencia de APIs y SDKs y el Control de versiones de APIs. Sabemos que los cambios rotundos no son ideales. A menos que se presente un problema extremo, no realizaremos cambios rotundos en nuestra API 4.0, que está disponible de forma general. Esperamos que la 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.