Looker API 现在使用查询 ID 的查询标签值

注意：本页所述的更改将分阶段发布：

• Looker 24.20（2024 年 12 月 4 日）：美洲早期客户
• Looker 25.0：美洲中型客户
• Looker 25.2：正式版 (GA)

以下 Looker 应用 API 方法不使用数值 query_id 值，对于查询 API，也不使用数值 id 值。以下方法改用查询 slug 值。

• Look API：

  • 复制外观
  • 创建 Look
  • 获取外观
  • 移动视图
  • 搜索外观
  • 更新外观
  • 获取所有 Look

• 信息中心 API：

  • 搜索信息中心元素
  • 获取 DashboardElement
  • 更新 DashboardElement
  • 获取所有 DashboardElement
  • 创建 DashboardElement

• 渲染任务 API：

  • 创建 Look 渲染任务
  • 创建查询呈现任务
  • 创建信息中心呈现任务
  • 获取渲染任务
  • 创建信息中心元素渲染任务

• 已安排的计划 API：

  • 聊天室的定期方案
  • 获取已安排的方案
  • 更新定期方案
  • 获取所有已安排的方案
  • 创建定期方案
  • 为“观看”设置定期投放计划
  • 信息中心的定期计划
  • LookML 信息中心的定期计划

• 查询 API：

  • 异步运行查询
  • 获取查询
  • 获取有关 Slug 的查询
  • 创建查询
  • 运行查询
  • 获取合并查询
  • 创建合并查询
  • 获取所有正在运行的查询

我需要做什么？

query_id 字段（对于查询 API，则为 id 字段）属于字符串数据类型。query_id 或 id 字段现在会在 API 响应中返回查询 slug 值。然后，您可以在任何 API 请求中使用该查询 slug 值。

例如，如果您要使用 Create Query API 创建查询，id 将是响应中的查询 slug。然后，您可以使用该 id 发出后续请求。

如果您为所列的任何 API 方法硬编码了数字查询 ID 值，则需要更新脚本以使用查询 slug 值！

如何查找查询的 Slug 值？

您可以通过以下方式查找查询的 Slug 值：

• 对于探索，您可以在探索的网址中找到网址中的 qid= 变量后面的 Slug。

• 您可以使用系统活动查找与数值查询 ID 关联的 Slug 值。

  注意： 如需查看“系统活动探索”，您必须拥有包含 see_system_activity 权限的角色。

  1. 在 Looker 的“探索”菜单中，依次选择 “系统活动”>“历史记录”探索。

  2. 在查询视图中，选择 ID 和关联维度。

  3. （可选）在 ID 维度上添加过滤条件，然后在查询 ID 过滤条件字段中输入查询的数字查询 ID。

  4. 点击运行。

     

  5. 点击“探索”结果中数字查询 ID 旁边的 [Query] 链接，即可根据该数字查询 ID 打开“探索”页面。

  6. 然后，您可以在“探索”的网址中使用该短标签，该短标签位于网址中的 qid= 变量后面。

如何判断我们是否使用了任何更新后的 API 端点？

您可以使用 API 用量系统活动探索查看对 Looker 实例进行的 API 调用列表。

1. 在 Looker 的探索菜单中，选择系统活动“探索”，然后选择 API 使用情况视图。

2. 依次选择创建日期 > 日期和端点维度以及总使用量测量值。

3. 在端点维度上添加过滤条件，然后在过滤条件字段中添加您要搜索的本文开头所列的任何更新后的端点。

4. 点击运行。Looker 会显示这些端点的使用情况信息。