Ten en cuenta que estás viendo la documentación de Looker. Para obtener documentación de Looker Studio, visita https://support.google.com/looker-studio.

Se usó la API de Cloud Translation para traducir esta página.

API de Looker 4.0 disponible de forma general

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 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 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 4.0 previa a la DG

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 tipo string en lugar de tipo int64.

Lee la siguiente tabla para conocer el impacto y las mitigaciones específicas del uso de tu extremo de la API 4.0:

Uso	Impacto potencial¹	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 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
SDKs con la compatibilidad de la comunidad²
SDK de Swift	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.
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 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 tiempo de ejecución, según la sensibilidad del tipo de lenguaje	Revisa el código en busca de dependencias en el tipo de campos de ID y agrega compatibilidad con campos de ID de tipo de cadena. Revisa también esta guía adicional.

1: Suponer 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 compatibles con la comunidad.

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. Consulta las políticas de compatibilidad de SDK y API para obtener más información.

Funciones adicionales de la API 4.0 de la versión GA

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, 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.
Busca grupos con jerarquía y roles.
Busca roles con el 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 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.
Mueve y copia los aspectos.
Incorporación firmada y no firmada, 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.
Limita y compensa 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 la especificación 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 versión GA de la API 4.0 reemplaza varios extremos de la API 3.1 obsoletos con 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 las carpetas 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 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 SDKs.
La API 4.0 presenta varias funciones y mejoras nuevas, como se indica en la sección Funciones adicionales de la versión GA 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 siempre puedes encontrar los cambios más recientes en nuestra referencia de la API. Para obtener más información, consulta Políticas de compatibilidad de la API y el SDK y Control de versiones de la API. 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.