此服务允许用户使用 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;
}
类
名称 | 简介 |
---|---|
AreaChartBuilder | 面积图构建器。 |
BarChartBuilder | 条形图构建器。 |
Chart | 一个 Chart 对象,可转换为静态图片。 |
ChartHiddenDimensionStrategy | 一个枚举,用于说明来源中隐藏的维度如何在图表中表示。 |
ChartMergeStrategy | 枚举如何在图表中表示来源中的多个范围。 |
ChartOptions | 公开当前为 Chart 配置的选项,例如高度、颜色等。 |
ChartType | Charts 服务支持的图表类型。 |
Charts | 在脚本中创建图表的入口点。 |
ColumnChartBuilder | 柱形图的构建器。 |
ColumnType | 枚举 DataTable 中列的有效数据类型。 |
CurveStyle | 枚举图表中曲线的样式。 |
DataTable | 在图表中使用的数据表。 |
DataTableBuilder | DataTable 对象的构建器。 |
DataTableSource | 可以用 DataTable 表示其数据的对象接口。 |
DataViewDefinition | 用于直观呈现图表数据的数据视图定义。 |
DataViewDefinitionBuilder | DataViewDefinition 对象的构建器。 |
LineChartBuilder | 折线图构建器。 |
MatchType | 一个枚举,用于说明应如何匹配字符串值。 |
NumberRangeFilterBuilder | 数字范围过滤器控件的构建器。 |
Orientation | 对对象方向的枚举。 |
PickerValuesLayout | 枚举如何在选择器 widget 中显示所选值。 |
PieChartBuilder | 饼图生成工具。 |
PointStyle | 枚举直线中点样式的枚举。 |
Position | 对图表中图例位置的枚举。 |
ScatterChartBuilder | 散点图构建器。 |
StringFilterBuilder | 字符串过滤器控件的构建器。 |
TableChartBuilder | 表格图表的构建器。 |
TextStyle | 文本样式配置对象。 |
TextStyleBuilder | 用于创建 TextStyle 对象的构建器。 |
AreaChartBuilder
方法
BarChartBuilder
方法
Chart
方法
方法 | 返回类型 | 简介 |
---|---|---|
getAs(contentType) | Blob | 返回此对象内的数据,并将其作为 blob 转换为指定内容类型。 |
getBlob() | Blob | 以 blob 的形式返回此对象内的数据。 |
getOptions() | ChartOptions | 返回此图表的选项,例如高度、颜色和轴。 |
ChartHiddenDimensionStrategy
属性
媒体资源 | 类型 | 说明 |
---|---|---|
IGNORE_BOTH | Enum | 默认:图表跳过任何隐藏的列和隐藏的行。 |
IGNORE_ROWS | Enum | 图表只会跳过隐藏的行。 |
IGNORE_COLUMNS | Enum | 图表只会跳过隐藏的列。 |
SHOW_BOTH | Enum | 图表不会跳过隐藏的列或隐藏的行。 |
ChartMergeStrategy
属性
媒体资源 | 类型 | 说明 |
---|---|---|
MERGE_COLUMNS | Enum | 默认此值。 |
MERGE_ROWS | Enum | 图表会合并多个范围的行。 |
ChartOptions
方法
方法 | 返回类型 | 简介 |
---|---|---|
get(option) | Object | 返回此图表的已配置选项。 |
getOrDefault(option) | Object | 返回此图表的已配置选项。 |
ChartType
属性
媒体资源 | 类型 | 说明 |
---|---|---|
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
属性
媒体资源 | 类型 | 说明 |
---|---|---|
ChartHiddenDimensionStrategy | ChartHiddenDimensionStrategy | 一个枚举,用于说明来源中隐藏的维度如何在图表中表示。 |
ChartMergeStrategy | ChartMergeStrategy | 枚举如何在图表中表示来源中的多个范围。 |
ChartType | ChartType | Charts 服务支持的图表类型的枚举。 |
ColumnType | ColumnType | 枚举 DataTable 中列的有效数据类型。 |
CurveStyle | CurveStyle | 枚举图表中曲线的样式。 |
PointStyle | PointStyle | 枚举直线中点样式的枚举。 |
Position | Position | 对图表中图例位置的枚举。 |
方法
方法 | 返回类型 | 简介 |
---|---|---|
newAreaChart() | AreaChartBuilder | 开始构建面积图,如 Google 图表工具文档中所述。 |
newBarChart() | BarChartBuilder | 开始构建条形图,如 Google 图表工具文档中所述。 |
newColumnChart() | ColumnChartBuilder | 开始构建柱形图,如 Google 图表工具文档中所述。 |
newDataTable() | DataTableBuilder | 创建一个空数据表,该表可手动设置其值。 |
newDataViewDefinition() | DataViewDefinitionBuilder | 创建新的数据视图定义。 |
newLineChart() | LineChartBuilder | 开始构建折线图,如 Google 图表工具文档中所述。 |
newPieChart() | PieChartBuilder | 开始构建饼图,如 Google 图表工具文档中所述。 |
newScatterChart() | ScatterChartBuilder | 开始构建散点图,如 Google 图表工具文档中所述。 |
newTableChart() | TableChartBuilder | 开始构建表格图表,如 Google 图表工具文档中所述。 |
newTextStyle() | TextStyleBuilder | 创建新的文本样式构建器。 |
ColumnChartBuilder
方法
ColumnType
属性
媒体资源 | 类型 | 说明 |
---|---|---|
DATE | Enum | 对应于日期值。 |
NUMBER | Enum | 对应于数值。 |
STRING | Enum | 对应于字符串值。 |
CurveStyle
属性
媒体资源 | 类型 | 说明 |
---|---|---|
NORMAL | Enum | 没有曲线的直线。 |
SMOOTH | Enum | 线条的角度已经过平滑处理。 |
DataTable
DataTableBuilder
方法
方法 | 返回类型 | 简介 |
---|---|---|
addColumn(type, label) | DataTableBuilder | 向数据表中添加一列。 |
addRow(values) | DataTableBuilder | 在数据表中添加一行。 |
build() | DataTable | 构建并返回数据表。 |
setValue(row, column, value) | DataTableBuilder | 在表中设置特定值。 |
DataTableSource
方法
方法 | 返回类型 | 简介 |
---|---|---|
getDataTable() | DataTable | 以 DataTable 的形式返回此对象内的数据。 |
DataViewDefinition
DataViewDefinitionBuilder
方法
方法 | 返回类型 | 简介 |
---|---|---|
build() | DataViewDefinition | 构建并返回使用此构建器构建的数据视图定义对象。 |
setColumns(columns) | DataViewDefinitionBuilder | 设置要包含在数据视图中的列索引,并指定角色-列信息。 |
LineChartBuilder
方法
MatchType
属性
媒体资源 | 类型 | 说明 |
---|---|---|
EXACT | Enum | 仅匹配完全匹配的值 |
PREFIX | Enum | 从值的开头开始匹配前缀 |
ANY | Enum | 匹配任何子字符串 |
方法
方法 | 返回类型 | 简介 |
---|---|---|
getName() | String | 返回要在选项 JSON 中使用的匹配类型的名称。 |
NumberRangeFilterBuilder
方法
方法 | 返回类型 | 简介 |
---|---|---|
setMaxValue(maxValue) | NumberRangeFilterBuilder | 为范围下限设置允许的最大值。 |
setMinValue(minValue) | NumberRangeFilterBuilder | 设置范围下限值。 |
setOrientation(orientation) | NumberRangeFilterBuilder | 设置滑块方向。 |
setShowRangeValues(showRangeValues) | NumberRangeFilterBuilder | 设置是否在显示选定范围范围的滑块旁边显示标签。 |
setTicks(ticks) | NumberRangeFilterBuilder | 设置范围过滤器滑块滑块可以落入的刻度线数量(范围栏中的固定位置)。 |
Orientation
属性
媒体资源 | 类型 | 说明 |
---|---|---|
HORIZONTAL | Enum | 水平方向。 |
VERTICAL | Enum | 垂直方向。 |
PickerValuesLayout
属性
媒体资源 | 类型 | 说明 |
---|---|---|
ASIDE | Enum | 所选值会显示在值选择器 widget 旁边的单个文本行中。 |
BELOW | Enum | 选定值会显示在微件下方的单个文本行中。 |
BELOW_WRAPPING | Enum | 与以下内容类似,但选择器中无法容纳的条目会换行。 |
BELOW_STACKED | Enum | 选定值会显示在微件下方的列中。 |
PieChartBuilder
方法
方法 | 返回类型 | 简介 |
---|---|---|
build() | Chart | 构建图表。 |
reverseCategories() | PieChartBuilder | 反转域轴上的序列绘制。 |
set3D() | PieChartBuilder | 将图表设置为三维。 |
setBackgroundColor(cssValue) | PieChartBuilder | 设置图表的背景颜色。 |
setColors(cssValues) | PieChartBuilder | 设置图表中线条的颜色。 |
setDataSourceUrl(url) | PieChartBuilder | 设置数据源网址,用于从外部来源(如 Google 表格)拉取数据。 |
setDataTable(tableBuilder) | PieChartBuilder | 使用 DataTableBuilder 设置要用于图表的数据表。 |
setDataTable(table) | PieChartBuilder | 设置数据表,其中包含图表的线条以及 X 轴标签。 |
setDataViewDefinition(dataViewDefinition) | PieChartBuilder | 设置要用于图表的数据视图定义。 |
setDimensions(width, height) | PieChartBuilder | 设置图表的尺寸。 |
setLegendPosition(position) | PieChartBuilder | 设置图例相对于图表的位置。 |
setLegendTextStyle(textStyle) | PieChartBuilder | 设置图表图例的文本样式。 |
setOption(option, value) | PieChartBuilder | 设置此图表的高级选项。 |
setTitle(chartTitle) | PieChartBuilder | 设置图表的标题。 |
setTitleTextStyle(textStyle) | PieChartBuilder | 设置图表标题的文本样式。 |
PointStyle
属性
媒体资源 | 类型 | 说明 |
---|---|---|
NONE | Enum | 不显示线点。 |
TINY | Enum | 使用微小的线点。 |
MEDIUM | Enum | 使用中等大小的线点。 |
LARGE | Enum | 使用大号的线点。 |
HUGE | Enum | 使用尺寸最大的线条点。 |
Position
属性
媒体资源 | 类型 | 说明 |
---|---|---|
TOP | Enum | 在图表上方。 |
RIGHT | Enum | 图表的右侧。 |
BOTTOM | Enum | 在图表下方。 |
NONE | Enum | 未显示图例。 |
ScatterChartBuilder
方法
StringFilterBuilder
方法
方法 | 返回类型 | 简介 |
---|---|---|
setCaseSensitive(caseSensitive) | StringFilterBuilder | 设置匹配时是否应区分大小写。 |
setMatchType(matchType) | StringFilterBuilder | 设置该控件是仅匹配精确值 (MatchType.EXACT )、与值开头部分的前缀 (MatchType.PREFIX ) 匹配,还是匹配任何子字符串 (MatchType.ANY )。 |
setRealtimeTrigger(realtimeTrigger) | StringFilterBuilder | 设置控件是在任何按键操作时都应该匹配,还是仅在输入字段“更改”(失去焦点或按 Enter 键)时匹配。 |
TableChartBuilder
方法
TextStyle
方法
方法 | 返回类型 | 简介 |
---|---|---|
getColor() | String | 获取文本样式的颜色。 |
getFontName() | String | 获取文本样式的字体名称。 |
getFontSize() | Number | 获取文本样式的字体大小。 |
TextStyleBuilder
方法
方法 | 返回类型 | 简介 |
---|---|---|
build() | TextStyle | 构建并返回使用此构建器构建的文本样式配置对象。 |
setColor(cssValue) | TextStyleBuilder | 设置文本样式的颜色。 |
setFontName(fontName) | TextStyleBuilder | 设置文本样式的字体名称 |
setFontSize(fontSize) | TextStyleBuilder | 设置文本样式的字体大小。 |