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 (el 4 de diciembre de 2024): Clientes de Americas Early
• Looker 25.0: Clientes de Americas Mid
• 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 query_id o, en el caso de las APIs de Query, un valor numérico id. En cambio, los siguientes métodos usan el valor de slug de la consulta.

• APIs de Look:

  • Copy Look
  • Create Look
  • Get Look
  • Move Look
  • Search Looks
  • Update Look
  • Get All Looks

• APIs de panel:

  • Search Dashboard Elements
  • Get DashboardElement
  • Update 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
  • Create Dashboard Element Render Task

• APIs de Scheduled Plan:

  • Scheduled Plans for Space
  • Get Scheduled Plan
  • Update Scheduled Plan
  • Get All Scheduled Plans
  • Create Scheduled Plan
  • Scheduled Plans for Look
  • Scheduled Plans for Dashboard
  • Scheduled Plans for LookML Dashboard

• APIs de Query:

  • Run Query Async
  • Get Query
  • Get Query for Slug
  • Create Query
  • Run Query
  • Get Merge Query
  • Create Merge Query
  • 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 muestran un valor de slug de consulta en la respuesta de la API. Luego, ese valor de slug de consulta se puede usar en cualquier solicitud de API.

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

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

¿Cómo encuentro el valor de slug de una consulta?

Puedes encontrar el valor de slug de una consulta de las siguientes maneras:

• En el caso de una exploración, puedes encontrar el slug en la URL de la exploración después de la variable qid= en la URL.

• Puedes encontrar el valor de slug asociado con un ID de consulta numérico con la actividad del sistema.

  Nota: Para ver las exploraciones de la actividad del sistema, debes tener una función que incluya el permiso see_system_activity.

  1. En el menú Explorar de Looker, selecciona la exploración 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, en el campo de filtro, ingresa el ID de consulta numérico de la consulta en el campo de filtro ID de consulta.

  4. Haz clic en Ejecutar.

     

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

  6. Luego, puedes usar el slug en la URL de la exploración, 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 la exploración de la actividad del sistema de uso de la API API Usage System Activity Explore.

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

2. Selecciona las dimensiones Fecha de creación > Fecha y Extremo , y la medida Uso total.

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

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