更新外观

版本 4.0.23.2

修改外观

可以使用此函数修改部分外观。在调用 update_look 时指定的属性值会应用于现有外观，因此无需添加值未更改的属性。最好仅指定要更改的属性，而不使用 update_look 调用中的其他属性。标记为“只读”的样式将被忽略。

当用户在 Looker 界面中删除样式时，样式数据会保留在数据库中，但会使用已删除的标志（“软删除”）进行标记。如果删除错误，则可以取消删除（由管理员删除）软删除的外观。

如需通过 API 软删除样式，请使用 update_look() 将样式的 deleted 属性更改为 true。您可以调用 update_look 以将样式的 deleted 属性更改为 false，从而取消删除样式。

软删除的外观已从 all_looks() 和 search_looks() 的结果中排除，因此即使它们仍存在于数据库中，它们也会从视图中消失。在 API 3.1 及更高版本中，您可以将 deleted: true 作为参数传递给 search_looks()，以便列出软删除外观。

注意：delete_look() 会执行“硬删除” - 样式数据会从 Looker 数据库中移除并销毁。没有对“delete_look()”的“撤消”操作。

请求

PATCH /looks/{look_id}
数据类型
说明
请求
HTTP 请求
路径
HTTP 路径
展开 HTTPPath 定义...
Look_id
字符串
样式 ID
body
HTTP 正文
展开 HTTPBody 定义...
body
Look
展开 LookWithQuery 定义...
可以
对象
当前用户可以对此对象执行的操作
content_metadata_id
字符串
内容元数据的 ID
id
字符串
唯一 ID
title
字符串
外观标题
user_id
字符串
用户 ID
content_favorite_id
字符串
内容收藏 ID
创建时间
字符串
Look 的创建时间。
已删除
布尔值
外观是否“软”删除。
已删除
字符串
Look 删除的时间。
deleter_id
字符串
删除样式的用户的 ID。
说明
字符串
说明
嵌入网址
字符串
嵌入网址
excel_file_url
字符串
Excel 文件网址
收藏次数
整数
被收藏的次数
google_spreadsheet_formula
字符串
Google 电子表格公式
image_embed_url
字符串
图片嵌入网址
is_run_on_load
布尔值
在查看 Look 时自动运行查询
上次访问日期：
字符串
任何用户上次访问 Look 的时间
last_updater_id（上次更新 ID）
字符串
上次更新外观的用户的 ID。
上次查看日期
字符串
Looker 网页界面中的上次查看时间
模型
模型
public
布尔值
是公开的
public_slug
字符串
公麋鹿
公开网址
字符串
公开网址
查询 ID
字符串
查询 ID
短网址
字符串
短网址
文件夹
文件夹
此外观的文件夹
文件夹 ID
字符串
文件夹 ID
更新时间
字符串
Look 更新的时间。
观看次数
整数
在 Looker 网页界面中查看次数
查询
查询
网址
字符串
网址
查询
HTTPQuery
展开 HTTPQuery 定义...
字段
字符串
请求的字段。

响应

200：查看

数据类型
说明
（对象）
可以
对象
当前用户可以对此对象执行的操作
content_metadata_id
字符串
内容元数据的 ID
id
字符串
唯一 ID
title
字符串
外观标题
user_id
字符串
用户 ID
content_favorite_id
字符串
内容收藏 ID
创建时间
字符串
Look 的创建时间。
已删除
布尔值
外观是否“软”删除。
已删除
字符串
Look 删除的时间。
deleter_id
字符串
删除样式的用户的 ID。
说明
字符串
说明
嵌入网址
字符串
嵌入网址
excel_file_url
字符串
Excel 文件网址
收藏次数
整数
被收藏的次数
google_spreadsheet_formula
字符串
Google 电子表格公式
image_embed_url
字符串
图片嵌入网址
is_run_on_load
布尔值
在查看 Look 时自动运行查询
上次访问日期：
字符串
任何用户上次访问 Look 的时间
last_updater_id（上次更新 ID）
字符串
上次更新外观的用户的 ID。
上次查看日期
字符串
Looker 网页界面中的上次查看时间
模型
模型
展开 LookModel 定义...
id
字符串
模型 ID
标签
字符串
模型标签
public
布尔值
是公开的
public_slug
字符串
公麋鹿
公开网址
字符串
公开网址
查询 ID
字符串
查询 ID
短网址
字符串
短网址
文件夹
文件夹
此外观的文件夹
展开 FolderBase 定义...
name
字符串
唯一名称
parent_id
字符串
父级的 ID。如果父 ID 为 null，这是一个根级条目
id
字符串
唯一 ID
content_metadata_id
字符串
内容元数据的 ID
创建时间
字符串
文件夹的创建时间
creator_id [创作者 ID]
字符串
创建者的用户 ID
儿童人数
整数
儿童数量
external_id
字符串
如果此文件夹通过单点登录外部登录中的“external_group_id”自动生成为嵌入共享文件夹，则嵌入者的 ID
is_embed
布尔值
文件夹是嵌入文件夹
is_embed_shared_root
布尔值
文件夹是根嵌入的共享文件夹
is_embed_users_root
布尔值
文件夹是根嵌入用户文件夹
是个人
布尔值
文件夹是用户的个人文件夹
is_personal_descendant
布尔值
文件夹是用户个人文件夹的后代
is_shared_root
布尔值
文件夹是根共享文件夹
is_users_root
布尔值
Folder 是根用户文件夹
可以
对象
当前用户可以对此对象执行的操作
文件夹 ID
字符串
文件夹 ID
更新时间
字符串
Look 更新的时间。
观看次数
整数
在 Looker 网页界面中查看次数
查询
查询
展开查询定义...
可以
对象
当前用户可以对此对象执行的操作
id
字符串
唯一 ID
模型
字符串
模型
视图
字符串
探索名称
字段
字符串 []
数据透视
字符串 []
fill_fields
字符串 []
filters
对象
过滤器
过滤条件表达式
字符串
过滤条件表达式
排序
字符串 []
限制
字符串
限制
列限制
字符串
列数上限
总计
布尔值
总计
总行数
字符串
原始总计
小计
字符串 []
vis_config
对象
可视化配置属性。这些属性通常不透明，因所用的可视化类型而异。没有已指定的一组允许的键。这些值可以是 JSON 支持的任何类型。通常具有存在字符串值的“类型”键，供 Looker 用来确定显示哪个可视化图表。可视化图表会忽略未知 vis_config 属性。
过滤条件配置
对象
filter_config 表示给定查询的探索页面上的过滤条件界面的状态。通过 Looker 界面运行查询时，此参数的优先级高于“过滤器”。创建查询或修改现有查询时，应将“filter_config”设置为 null。将其设置为任何其他值都可能会导致意外的过滤行为。该格式应视为不透明。
visible_ui_sections
字符串
可见界面部分
处理后标题
字符串
Slug
动态字段
字符串
动态字段
client_id
字符串
客户端 ID：用于生成缩短的探索网址。如果由客户端设置，则必须是唯一的 22 位字母数字字符串。否则，系统会生成一个。
分享网址
字符串
分享网址
展开网址共享网址
字符串
展开后的共享网址
网址
字符串
展开后的网址
query_timezone
字符串
查询时区
has_table_calculations
布尔值
包含表计算
网址
字符串
网址

400：错误请求

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

404：未找到

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

422：验证错误

数据类型
说明
（对象）
消息
字符串
错误详情
展开 ValidationErrorDetail 定义...
字段
字符串
出错的字段
代码
字符串
错误代码
消息
字符串
错误信息消息
文档网址
字符串
文档链接
文档网址
字符串
文档链接

429：请求数过多

数据类型
说明
（对象）
消息
字符串
错误详情
文档网址
字符串
文档链接

示例