借助此服务,用户可以使用 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 | 设置文本样式的字体大小。 |