借助此服务,用户可以使用 Google 图表工具创建图表,并在服务器端呈现这些图表。如果您想在网络浏览器中渲染图表,请改用 Google Charts API。
以下示例创建了一个基本的数据表格,并使用数据填充了面积图,然后将其作为图片添加到网页中:
function doGet() {
var data = Charts.newDataTable()
.addColumn(Charts.ColumnType.STRING, 'Month')
.addColumn(Charts.ColumnType.NUMBER, 'In Store')
.addColumn(Charts.ColumnType.NUMBER, 'Online')
.addRow(['January', 10, 1])
.addRow(['February', 12, 1])
.addRow(['March', 20, 2])
.addRow(['April', 25, 3])
.addRow(['May', 30, 4])
.build();
var chart = Charts.newAreaChart()
.setDataTable(data)
.setStacked()
.setRange(0, 40)
.setTitle('Sales per Month')
.build();
var htmlOutput = HtmlService.createHtmlOutput().setTitle('My Chart');
var imageData = Utilities.base64Encode(chart.getAs('image/png').getBytes());
var imageUrl = "data:image/png;base64," + encodeURI(imageData);
htmlOutput.append("Render chart server side: <br/>");
htmlOutput.append("<img border=\"1\" src=\"" + imageUrl + "\">");
return htmlOutput;
}
类
名称 | 简介 |
---|---|
Area | 面积图的构建器。 |
Bar | 条形图的构建器。 |
Chart | 一个图表对象,可转换为静态图片。 |
Chart | 枚举了来源中隐藏维度在图表中的表示方式。 |
Chart | 枚举了来源中多个范围在图表中的表示方式。 |
Chart | 公开当前为 Chart 配置的选项,例如高度、颜色等。 |
Chart | Charts 服务支持的图表类型。 |
Charts | 在脚本中创建图表的入口点。 |
Column | 柱形图的构建器。 |
Column | Data 中列的有效数据类型的枚举。 |
Curve | 图表中曲线的样式枚举。 |
Data | 要在图表中使用的“数据表格”。 |
Data | DataTable 对象的构建器。 |
Data | 可将其数据表示为 Data 的对象的接口。 |
Data | 用于可视化图表数据的数据视图定义。 |
Data | Data 对象的构建器。 |
Line | 折线图的构建器。 |
Match | 枚举,用于说明应如何匹配字符串值。 |
Number | 数字范围过滤条件控件的构建器。 |
Orientation | 对象方向的枚举。 |
Picker | 枚举了如何在选择器微件中显示所选值。 |
Pie | 饼图的构建器。 |
Point | 线条中点的样式的枚举。 |
Position | 图表中图例位置的枚举。 |
Scatter | 散点图的构建器。 |
String | 字符串过滤器控件的构建器。 |
Table | 表格图表的构建器。 |
Text | 文本样式配置对象。 |
Text | 用于创建 Text 对象的构建器。 |
Area Chart Builder
方法
Bar Chart Builder
方法
Chart
方法
方法 | 返回类型 | 简介 |
---|---|---|
get | Blob | 将此对象内的数据作为转换为指定内容类型的 blob 返回。 |
get | Blob | 以 blob 的形式返回此对象内的数据。 |
get | Chart | 返回此图表的选项,例如高度、颜色和轴。 |
Chart Hidden Dimension Strategy
属性
属性 | 类型 | 说明 |
---|---|---|
IGNORE_BOTH | Enum | 默认;图表会跳过所有隐藏的列和隐藏的行。 |
IGNORE_ROWS | Enum | 图表仅会跳过隐藏的行。 |
IGNORE_COLUMNS | Enum | 图表仅会跳过隐藏的列。 |
SHOW_BOTH | Enum | 图表不会跳过隐藏的列或隐藏的行。 |
Chart Merge Strategy
属性
属性 | 类型 | 说明 |
---|---|---|
MERGE_COLUMNS | Enum | 默认。 |
MERGE_ROWS | Enum | 图表会合并多个范围的行。 |
Chart Options
方法
方法 | 返回类型 | 简介 |
---|---|---|
get(option) | Object | 返回此图表的已配置选项。 |
get | Object | 返回此图表的已配置选项。 |
Chart Type
属性
属性 | 类型 | 说明 |
---|---|---|
TIMELINE | Enum | 时间表图。 |
AREA | Enum | 面积图 |
BAR | Enum | 条形图 |
BUBBLE | Enum | 气泡图。 |
CANDLESTICK | Enum | K 线图。 |
COLUMN | Enum | 柱形图 |
COMBO | Enum | 组合图表 |
GAUGE | Enum | 刻度盘图。 |
GEO | Enum | 地理图表。 |
HISTOGRAM | Enum | 直方图 |
RADAR | Enum | 雷达图。 |
LINE | Enum | 折线图 |
ORG | Enum | 组织结构图。 |
PIE | Enum | 饼图 |
SCATTER | Enum | 散点图 |
SPARKLINE | Enum | 火花谱线图。 |
STEPPED_AREA | Enum | 阶梯面积图。 |
TABLE | Enum | 表格图表 |
TREEMAP | Enum | 树状图。 |
WATERFALL | Enum | 瀑布图。 |
Charts
属性
属性 | 类型 | 说明 |
---|---|---|
Chart | Chart | 枚举了来源中隐藏维度在图表中的表示方式。 |
Chart | Chart | 枚举了来源中多个范围在图表中的表示方式。 |
Chart | Chart | Charts 服务支持的图表类型的枚举。 |
Column | Column | Data 中列的有效数据类型的枚举。 |
Curve | Curve | 图表中曲线的样式枚举。 |
Point | Point | 线条中点的样式的枚举。 |
Position | Position | 图表中图例位置的枚举。 |
方法
方法 | 返回类型 | 简介 |
---|---|---|
new | Area | 开始构建面积图,如 Google 图表工具文档中所述。 |
new | Bar | 开始构建条形图,如 Google 图表工具文档中所述。 |
new | Column | 开始构建柱形图,如 Google 图表工具文档中所述。 |
new | Data | 创建一个空数据表,其值可以手动设置。 |
new | Data | 创建新的“数据视图”定义。 |
new | Line | 开始构建折线图,如 Google 图表工具文档中所述。 |
new | Pie | 开始构建饼图,如 Google 图表工具文档中所述。 |
new | Scatter | 开始构建散点图,如 Google 图表工具文档中所述。 |
new | Table | 开始构建表格图表,如 Google 图表工具文档中所述。 |
new | Text | 创建新的文本样式构建器。 |
Column Chart Builder
方法
Column Type
属性
属性 | 类型 | 说明 |
---|---|---|
DATE | Enum | 对应于日期值。 |
NUMBER | Enum | 对应于数值。 |
STRING | Enum | 对应于字符串值。 |
Curve Style
属性
属性 | 类型 | 说明 |
---|---|---|
NORMAL | Enum | 不含曲线的直线。 |
SMOOTH | Enum | 线条的角度会被平滑处理。 |
Data Table
Data Table Builder
方法
方法 | 返回类型 | 简介 |
---|---|---|
add | Data | 向数据表格添加列。 |
add | Data | 向数据表中添加一行。 |
build() | Data | 构建并返回数据表格。 |
set | Data | 在表中设置特定值。 |
Data Table Source
方法
方法 | 返回类型 | 简介 |
---|---|---|
get | Data | 将此对象内的数据作为 DataTable 返回。 |
Data View Definition
Data View Definition Builder
方法
方法 | 返回类型 | 简介 |
---|---|---|
build() | Data | 构建并返回使用此构建器构建的数据视图定义对象。 |
set | Data | 设置要包含在数据视图中的列的编号,以及指定角色-列信息。 |
Line Chart Builder
方法
Match Type
属性
属性 | 类型 | 说明 |
---|---|---|
EXACT | Enum | 仅匹配完全匹配的值 |
PREFIX | Enum | 从值开头匹配前缀 |
ANY | Enum | 匹配任何子字符串 |
方法
方法 | 返回类型 | 简介 |
---|---|---|
get | String | 返回要在选项 JSON 中使用的匹配类型的名称。 |
Number Range Filter Builder
方法
方法 | 返回类型 | 简介 |
---|---|---|
set | Number | 设置范围下限范围的允许最大值。 |
set | Number | 设置范围下限的最小值。 |
set | Number | 设置滑块方向。 |
set | Number | 设置是否在滑块旁边显示所选范围的范围。 |
set | Number | 设置数字范围过滤条件滑块滑块头可落在的刻度数(范围栏中的固定位置)。 |
Orientation
属性
属性 | 类型 | 说明 |
---|---|---|
HORIZONTAL | Enum | 横向。 |
VERTICAL | Enum | 竖屏。 |
Picker Values Layout
属性
属性 | 类型 | 说明 |
---|---|---|
ASIDE | Enum | 所选值会显示在值选择器微件旁边的一行文本中。 |
BELOW | Enum | 所选值会显示在微件下方的单行文本中。 |
BELOW_WRAPPING | Enum | 与下方类似,但无法在选择器中显示的条目会换行显示。 |
BELOW_STACKED | Enum | 所选值会显示在微件下方的列中。 |
Pie Chart Builder
方法
方法 | 返回类型 | 简介 |
---|---|---|
build() | Chart | 构建图表。 |
reverse | Pie | 反转领域轴中系列图表的绘制方向。 |
set3D() | Pie | 将图表设为三维图表。 |
set | Pie | 设置图表的背景颜色。 |
set | Pie | 设置图表中线条的颜色。 |
set | Pie | 设置用于从外部来源(例如 Google 表格)提取数据的数据源网址。 |
set | Pie | 使用 DataTableBuilder 设置要用于图表的数据表。 |
set | Pie | 设置包含图表线条和 X 轴标签的数据表。 |
set | Pie | 设置要用于图表的数据视图定义。 |
set | Pie | 设置图表的尺寸。 |
set | Pie | 设置图例相对于图表的位置。 |
set | Pie | 设置图表图例的文本样式。 |
set | Pie | 设置此图表的高级选项。 |
set | Pie | 设置图表的标题。 |
set | Pie | 设置图表标题的文本样式。 |
Point Style
属性
属性 | 类型 | 说明 |
---|---|---|
NONE | Enum | 不显示线条点。 |
TINY | Enum | 使用细小的线条点。 |
MEDIUM | Enum | 使用中等大小的线条点。 |
LARGE | Enum | 使用较大的线条点。 |
HUGE | Enum | 使用尺寸最大的线条点。 |
Position
属性
属性 | 类型 | 说明 |
---|---|---|
TOP | Enum | 图表上方。 |
RIGHT | Enum | 图表右侧。 |
BOTTOM | Enum | 图表下方。 |
NONE | Enum | 系统不会显示图例。 |
Scatter Chart Builder
方法
String Filter Builder
方法
方法 | 返回类型 | 简介 |
---|---|---|
set | String | 设置匹配是否应区分大小写。 |
set | String | 设置控件是否应仅与确切值 (Match )、从值开头开始的前缀 (Match ) 或任何子字符串 (Match ) 匹配。 |
set | String | 设置控件是否应在按下任意键时进行匹配,还是仅在输入字段发生“更改”(失去焦点或按下 Enter 键)时进行匹配。 |
Table Chart Builder
方法
Text Style
方法
方法 | 返回类型 | 简介 |
---|---|---|
get | String | 获取文本样式的颜色。 |
get | String | 获取文本样式的字体名称。 |
get | Number | 获取文本样式的字体大小。 |
Text Style Builder
方法
方法 | 返回类型 | 简介 |
---|---|---|
build() | Text | 构建并返回使用此构建器构建的文本样式配置对象。 |
set | Text | 设置文本样式的颜色。 |
set | Text | 设置文本样式的字体名称。 |
set | Text | 设置文本样式的字体大小。 |