社区可视化图表的数据和样式选项在配置 JSON 中定义。data
配置设置了可视化图表支持的维度和指标的数量。style
配置定义了属性面板中可用的样式选择器。
数据配置
data
配置定义了 Looker Studio 在属性面板中呈现的 DIMENSION 和 METRIC 元素。每个元素都与最终用户作为输入向可视化图表提供的维度和元素字段相对应。
数据元素示例:
{
"id": "twoDimensionsPlease",
"label": "Dimension Element Heading",
"type": "DIMENSION",
"options": {
"min": 2,
"max": 2,
}
}
您在数据元素中定义的 id
包含在 Looker Studio 返回的信息中。label
定义了用户在数据部分上方看到的文本,type
定义了它是维度还是指标。options
对象定义了用户可以添加到数据元素中的字段数下限和上限。
在 DIMENSION 数据元素中,options
对象支持可选的 supportedTypes
键。如果已定义,Looker 数据洞察会限制可添加到该元素的维度字段的类型。supportedTypes
的值是一个数组,可包含“DEFAULT”、“TIME”和“GEO”的任意组合。
数据部分将多个数据元素汇总在一起。Looker 数据洞察会将 label
呈现为多个数据元素的标题。
数据部分示例:
{
"id": "dimensionSection1",
"label": "Dimension Section Heading",
"elements":[
// array of data elements
]
}
此屏幕截图显示了 Looker Studio 如何呈现上面的数据部分和数据元素:
样式配置
样式配置定义了属性面板中呈现的样式选择器。
样式元素示例:
{
"id": "linkOpacity",
"label": "Link opacity",
"type": "OPACITY",
"defaultValue": "0.2"
}
label
定义了用户看到的提示文本,type
定义了 Looker Studio 呈现的样式选择器的类型。(可选)defaultValue
会为每个样式元素定义一个默认值。
与数据元素类似,样式元素是在部分内定义的,这些部分提供标题和逻辑分组。要查看可用选择器的完整列表,请参阅配置参考。
样式部分示例:
{
"id": "styleGroup1",
"label": "Header for style group",
"elements": [
// insert Style Elements here
]
}
下面的屏幕截图显示了样式面板的一个示例,其中包含一个不透明度选择器,它提供与样式元素中的 label
对应的提示“Link Opacity”。
互动配置
interaction
配置定义了图表互动如何用于社区可视化图表。这是可选项。
例如:
{
"id": "onClick",
"supportedActions": ["FILTER"]
}
目前仅支持 FILTER
。如果您配置了互动,则属性面板中会显示一个复选框。
功能配置
features
配置可以启用或停用社区可视化图表中的各种功能。此部分为可选。在配置参考中可以找到功能列表。
例如:
"features": {
"enableComparisonDateRange": true
}
示例
要查看可视化图表配置的示例,请参阅示例配置。
后续步骤
定义配置后,即可编写可视化图表。