La API de Looker ahora usa valores de fragmento de consulta para los IDs de consulta.

Nota: El cambio que se describe en esta página se lanzará en fases:

• Looker 24.20 (4 de diciembre de 2024): Clientes de América del Norte
• Looker 25.0: Clientes de nivel medio de América
• Looker 25.2: Disponibilidad general (DG)

Los siguientes métodos de la API de la aplicación de Looker no usan un valor numérico de query_id o, en el caso de las APIs de Query, un valor numérico de id. Los siguientes métodos usan el valor de slug de la consulta.

• APIs de Look:

  • Copiar aspecto
  • Crear vista
  • Get Look
  • Move Look
  • Looks de la Búsqueda
  • Actualizar el aspecto
  • Get All Looks

• APIs del panel:

  • Cómo buscar elementos del panel
  • Get DashboardElement
  • Actualiza DashboardElement
  • Get All DashboardElements
  • Create DashboardElement

• APIs de Render Task:

  • Create Look Render Task
  • Create Query Render Task
  • Create Dashboard Render Task
  • Get Render Task
  • Crear tarea de renderización de elementos del panel

• APIs de Scheduled Plan:

  • Planes programados para el espacio
  • Get Scheduled Plan
  • Actualizar plan programado
  • Get All Scheduled Plans
  • Create Scheduled Plan
  • Planes programados para la visualización
  • Planes programados para el panel
  • Planes programados para el panel de LookML

• APIs de consulta:

  • Run Query Async
  • Obtener consulta
  • Get Query for Slug
  • Crear consulta
  • Ejecutar consulta
  • Obtener consulta de combinación
  • Crear consulta de combinación
  • Get All Running Queries

¿Qué debo hacer?

El campo query_id o, en el caso de las APIs de Query, el campo id, es un tipo de datos de cadena. Los campos query_id o id ahora devuelven un valor de slug de búsqueda en la respuesta de la API. Luego, ese valor de slug de la búsqueda se puede usar en cualquier solicitud a la API.

Por ejemplo, si crearas una consulta con la API de Create Query, el id sería el slug de la consulta en la respuesta. Luego, podrías usar ese id para realizar una solicitud posterior.

Si codificaste valores de ID de búsqueda numéricos para cualquiera de los métodos de la API enumerados, debes actualizar tus secuencias de comandos para usar valores de slug de búsqueda.

¿Cómo encuentro el valor de slug para una búsqueda?

Puedes encontrar el valor del slug de una búsqueda de las siguientes maneras:

• En el caso de un Explore, puedes encontrar el slug en la URL del Explore después de la variable qid=.

• Puedes encontrar el valor de slug asociado a un ID de búsqueda numérico con Actividad del sistema.

  Nota: Para ver los Explorar de Actividad del sistema, debes tener un rol que incluya el permiso see_system_activity.

  1. En el menú Explorar de Looker, selecciona el Explorar Actividad del sistema > Historial.

  2. En la vista Consulta, selecciona las dimensiones ID y Vínculo.

  3. De manera opcional, agrega un filtro en la dimensión ID y, luego, ingresa el ID numérico de la búsqueda en el campo de filtro ID de búsqueda.

  4. Haz clic en Ejecutar.

     

  5. Haz clic en el vínculo [Query] junto al ID de búsqueda numérico en los resultados de Explorar para abrir una exploración basada en ese ID de búsqueda numérico.

  6. Luego, puedes usar el slug en la URL de Explorar, que sigue a la variable qid= en la URL.

¿Cómo puedo saber si usamos alguno de los extremos de API actualizados?

Puedes ver una lista de las llamadas a la API que se realizaron a tu instancia de Looker con el Explorar Actividad del sistema de uso de la API.

1. En el menú Explorar de Looker, selecciona el Explorar Actividad del sistema y, luego, selecciona la vista Uso de la API.

2. Selecciona las dimensiones Fecha de creación > Fecha y Endpoint, y la métrica Uso total.

3. Agrega un filtro en la dimensión Endpoint y, en el campo de filtro, incluye cualquiera de los extremos actualizados que se indican al comienzo de este documento y que quieras buscar.

4. Haz clic en Ejecutar. Looker mostrará la información de uso de esos extremos.