L'API Looker utilise désormais des valeurs de slug de requête pour les ID de requête
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les méthodes d'API d'application Looker suivantes n'utilisent pas de valeur numérique query_id ni, dans le cas des API de requête, de valeur numérique id. Les méthodes suivantes utilisent plutôt la valeur du slug de la requête.
Le champ query_id ou, dans le cas des API de requête, le champ id, est un type de données de chaîne. Les champs query_id ou id renvoient désormais une valeur de slug de requête dans la réponse de l'API. Cette valeur de slug de requête peut ensuite être utilisée dans toutes les requêtes API.
Par exemple, si vous créez une requête avec l'API Create Query (Créer une requête), id correspond au slug de la requête dans la réponse. Vous pouvez ensuite utiliser cet id pour effectuer une requête ultérieure.
Si vous avez des valeurs d'ID de requête numérique codées en dur pour l'une des méthodes d'API listées, vous devez mettre à jour vos scripts pour utiliser des valeurs de slug de requête.
Comment trouver la valeur du slug d'une requête ?
Vous pouvez trouver la valeur du slug d'une requête de différentes manières:
Pour une exploration, vous pouvez trouver le slug dans l'URL de l'exploration après la variable qid=.
Vous pouvez trouver la valeur slug associée à un ID de requête numérique à l'aide de Activité système.
Dans la vue Requête, sélectionnez les dimensions ID et Lien.
Vous pouvez également ajouter un filtre sur la dimension ID et saisir l'ID numérique de la requête dans le champ de filtre ID de la requête.
Cliquez sur Exécuter.
Cliquez sur le lien [Query] à côté de l'ID de requête numérique dans les résultats de l'exploration pour ouvrir une exploration basée sur cet ID de requête numérique.
Vous pouvez ensuite utiliser le slug dans l'URL de l'exploration, qui suit la variable qid= dans l'URL.
Comment savoir si nous utilisons l'un des points de terminaison de l'API mis à jour ?
Dans le menu Explorer de Looker, sélectionnez l'exploration Activité système, puis la vue Utilisation de l'API.
Sélectionnez les dimensions Date de création > Date et Point de terminaison, ainsi que la mesure Consommation totale.
Ajoutez un filtre à la dimension Point de terminaison et, dans le champ de filtre, incluez les points de terminaison mis à jour listés au début de ce document que vous souhaitez rechercher.
Cliquez sur Exécuter. Looker affiche des informations sur l'utilisation de ces points de terminaison.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/05 (UTC)."],[],[],null,["# The Looker API now uses query slug values for query IDs\n\n| **Note:** The change described on this page will be released in phases:\n|\n| - Looker 24.20 (on December 4, 2024): Americas Early customers\n| - Looker 25.0: Americas Mid customers\n| - Looker 25.2: General Availability (GA)\n\nThe following Looker application API methods don't use a numeric `query_id` value or, in the case of the Query APIs, a numeric `id` value. The following methods use the query slug value instead.\n\n- Look APIs:\n\n - [Copy Look](/looker/docs/reference/looker-api/latest/methods/Look/copy_look)\n - [Create Look](/looker/docs/reference/looker-api/latest/methods/Look/create_look)\n - [Get Look](/looker/docs/reference/looker-api/latest/methods/Look/look)\n - [Move Look](/looker/docs/reference/looker-api/latest/methods/Look/move_look)\n - [Search Looks](/looker/docs/reference/looker-api/latest/methods/Look/search_looks)\n - [Update Look](/looker/docs/reference/looker-api/latest/methods/Look/update_look)\n - [Get All Looks](/looker/docs/reference/looker-api/latest/methods/Look/all_looks)\n- Dashboard APIs:\n\n - [Search Dashboard Elements](/looker/docs/reference/looker-api/latest/methods/Dashboard/search_dashboard_elements)\n - [Get DashboardElement](/looker/docs/reference/looker-api/latest/methods/Dashboard/dashboard_element)\n - [Update DashboardElement](/looker/docs/reference/looker-api/latest/methods/Dashboard/update_dashboard_element)\n - [Get All DashboardElements](/looker/docs/reference/looker-api/latest/methods/Dashboard/dashboard_dashboard_elements)\n - [Create DashboardElement](/looker/docs/reference/looker-api/latest/methods/Dashboard/create_dashboard_element)\n- Render Task APIs:\n\n - [Create Look Render Task](/looker/docs/reference/looker-api/latest/methods/RenderTask/create_look_render_task)\n - [Create Query Render Task](/looker/docs/reference/looker-api/latest/methods/RenderTask/create_query_render_task)\n - [Create Dashboard Render Task](/looker/docs/reference/looker-api/latest/methods/RenderTask/create_dashboard_render_task)\n - [Get Render Task](/looker/docs/reference/looker-api/latest/methods/RenderTask/render_task)\n - [Create Dashboard Element Render Task](/looker/docs/reference/looker-api/latest/methods/RenderTask/create_dashboard_element_render_task)\n- Scheduled Plan APIs:\n\n - [Scheduled Plans for Space](/looker/docs/reference/looker-api/latest/methods/ScheduledPlan/scheduled_plans_for_space)\n - [Get Scheduled Plan](/looker/docs/reference/looker-api/latest/methods/ScheduledPlan/scheduled_plan)\n - [Update Scheduled Plan](/looker/docs/reference/looker-api/latest/methods/ScheduledPlan/update_scheduled_plan)\n - [Get All Scheduled Plans](/looker/docs/reference/looker-api/latest/methods/ScheduledPlan/all_scheduled_plans)\n - [Create Scheduled Plan](/looker/docs/reference/looker-api/latest/methods/ScheduledPlan/create_scheduled_plan)\n - [Scheduled Plans for Look](/looker/docs/reference/looker-api/latest/methods/ScheduledPlan/scheduled_plans_for_look)\n - [Scheduled Plans for Dashboard](/looker/docs/reference/looker-api/latest/methods/ScheduledPlan/scheduled_plans_for_dashboard)\n - [Scheduled Plans for LookML Dashboard](/looker/docs/reference/looker-api/latest/methods/ScheduledPlan/scheduled_plans_for_lookml_dashboard)\n- Query APIs:\n\n - [Run Query Async](/looker/docs/reference/looker-api/latest/methods/Query/create_query_task)\n - [Get Query](/looker/docs/reference/looker-api/latest/methods/Query/query)\n - [Get Query for Slug](/looker/docs/reference/looker-api/latest/methods/Query/query_for_slug)\n - [Create Query](/looker/docs/reference/looker-api/latest/methods/Query/create_query)\n - [Run Query](/looker/docs/reference/looker-api/latest/methods/Query/run_query)\n - [Get Merge Query](/looker/docs/reference/looker-api/latest/methods/Query/merge_query)\n - [Create Merge Query](/looker/docs/reference/looker-api/latest/methods/Query/create_merge_query)\n - [Get All Running Queries](/looker/docs/reference/looker-api/latest/methods/Query/all_running_queries)\n\nWhat do I need to do?\n---------------------\n\nThe `query_id` field or, in the case of the Query APIs, the `id` field, is a string data type. The `query_id` or `id` fields now return a query slug value in the API response. That query slug value can then be used in any API requests.\n\nFor example, if you were to create a query with the **Create Query** API, the `id` would be the query slug in the response. You could then use that `id` to make a subsequent request.\n\nIf you have hard-coded numeric query ID values for any of the listed API methods, **you need to update your scripts to use query slug values**!\n\nHow do I find the slug value for a query?\n-----------------------------------------\n\nYou can find the slug value for a query in the following ways:\n\n- For an Explore, you can find the slug in the Explore's URL following the `qid=` variable in the URL.\n\n- You can find the slug value that is associated with a numeric query ID using [System Activity](/looker/docs/usage-reports-with-system-activity-explores).\n\n | **Note:** To view the System Activity Explores, you must have a [role](/looker/docs/admin-panel-users-roles) that includes the [`see_system_activity` permission](/looker/docs/admin-panel-users-roles#see_system_activity).\n 1. From the Looker **Explore menu** , select the [**System Activity \\\u003e History** Explore](/looker/docs/usage-reports-with-system-activity-explores#history).\n\n 2. From the **Query** view, select the **ID** and **Link** dimensions.\n\n 3. Optionally, add a filter on the **ID** dimension, and enter the query's numeric query ID in the **Query ID** filter field.\n\n 4. Click **Run**.\n\n 5. Click the `[Query]` link next to the numeric query ID in the Explore results to open an Explore based on that numeric query ID.\n\n 6. You can then use the slug in the Explore's URL, which follows the `qid=` variable in the URL.\n\nHow can I tell if we use any of the updated API endpoints?\n----------------------------------------------------------\n\nYou can view a list of the API calls that were made to your Looker instance using the [API Usage System Activity Explore](/looker/docs/usage-reports-with-system-activity-explores#api_usage).\n\n1. From the Looker **Explore** menu, select the **System Activity** Explore, and then select the **API Usage** view.\n\n2. Select the **Created Date \\\u003e Date** and **Endpoint** dimensions and the **Total Usage** measure.\n\n3. Add a filter on the **Endpoint** dimension, and, in the filter field, include any of the updated endpoints listed at the beginning of this document that you want to search for.\n\n4. Click **Run**. Looker will display usage information for those endpoints."]]