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.

La API de Looker 4.0 está 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 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 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 él, se abordan los cambios rotundos y las mitigaciones disponibles cuando migras a la versión GA 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.

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 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 de Looker para dispositivos móviles
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 del entorno 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 entorno 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
Cómo usar la API de 4.0 sin un SDK (o con bibliotecas proporcionadas externamente)	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. Consulta también esta guía 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: Compatibilidad con la API y el SDK de Looker Looker no admite oficialmente las bibliotecas con asistencia de la comunidad.

Usuarios de la API 3.1

Si usas la API 3.1, lee esta sección. En él, 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. Para obtener más información, consulta las políticas de asistencia de SDKs y APIs.

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

Para tu comodidad, enumeramos los cambios más notables y útiles de la API 4.0 de Additive:

Creación y administración de tableros, elementos y secciones de tableros Consulta la página de documentación de las tablas para obtener más información sobre ellas.
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.
Obtén y establece la configuración de la instancia de Looker. Consulta la página de documentación de la configuración para obtener más informació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 looks
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 de acceso.
Limita y compensa los resultados para 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 API 4.0 de la versión GA

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 de la página principal obsoletos. Usa los extremos de tablero en lugar de las páginas principales. Consulta Presentar contenido con pizarras.
Se quitaron los extremos de Space obsoletos. Usa los extremos de carpeta en lugar de Space. Consulta Organización y administración del acceso al contenido.

Usuarios de la API 3.0

La API 3.0 dejó de estar disponible 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 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 surja un problema extremo, no realizaremos ningún cambio rotundo en nuestra API 4.0 de disponibilidad general. Esperamos que nuestra API de Looker 4.0 de disponibilidad general te ayude a desarrollar con más productividad y facilidad en la plataforma de Looker.