Nos complace anunciar que la API de Looker 4.0 está disponible de forma general en Looker 22.4. La API 4.0 (API 4.0 GA) disponible de manera general tiene varios cambios rotundos y aditivos, y promueve múltiples endpoints de Beta a estable. Consulta nuestra referencia de la API para obtener especificaciones detalladas de la API 4.0. Actualizamos nuestros SDK compatibles con Looker y con la comunidad para admitir extremos de DG de la API de Looker 4.0. Para obtener más información, consulta Políticas de compatibilidad de la API y el SDK y 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 DG en 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 disponibilidad general de la API 4.0 incluye el cambio de todos los campos de ID de la entidad del tipo numérico integer
al tipo string
. Por ejemplo, el extremo GET /groups/{group_id}
muestra id
como el tipo string
en lugar del 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 | Pídeles a los usuarios que actualicen a la versión más reciente de las apps de Looker para dispositivos móviles |
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 de 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 | Actualizar el SDK a la versión 22.0 (y versiones posteriores) y, luego, resolver los errores de tipo resultantes, si los |
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. En ella, se abordan 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 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, te mostramos los cambios aditivos más destacados y útiles de la API 4.0:
- 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.
- Buscar 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 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.
- 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 Presentar contenido con pizarras.
- Se quitaron los extremos obsoletos del espacio. Usa los extremos de carpeta en lugar de Space. 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 compatibles con Looker y con 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 que se agreguen nuevas funciones y cambios adicionales 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.