Charts

integer

图表的 ID。

object (ChartSpec)

图表的规范。

object (EmbeddedObjectPosition)

图表的位置。

object (EmbeddedObjectBorder)

图表的边框。

string

图表的标题。

string

用于描述图表的替代文本。这通常用于确保可访问性。

object (TextFormat)

标题文本格式。不支持删除线、下划线和链接。

object (TextPosition)

标题文本的位置。此字段是可选字段。

string

图表的副标题。

object (TextFormat)

字幕文本格式。不支持删除线、下划线和链接。

object (TextPosition)

副标题文本位置。此字段是可选字段。

string

默认情况下用于所有图表文本（例如标题、轴标签、图例）的字体的名称。如果为图表的特定部分指定了字体，则该字体会替换此字体名称。

boolean

设置为 true 可使图表填充其呈现的整个空间，并尽可能减少内边距。设为 false 以使用默认内边距。（不适用于地理图表和组织结构图）。

object (Color)

整个图表的背景颜色。不适用于组织结构图。已废弃：请使用 backgroundColorStyle。

object (ColorStyle)

整个图表的背景颜色。不适用于组织结构图。如果同时设置了 backgroundColor，则此字段优先。

object (DataSourceChartProperties)

如果存在，该字段包含数据源图表专用属性。

object (FilterSpec)

应用于图表源数据的过滤条件。仅适用于数据源图表。

object (SortSpec)

用于对图表数据进行排序的顺序。仅支持单个排序规范。仅适用于数据源图表。

enum (ChartHiddenDimensionStrategy)

确定图表将如何使用隐藏的行或列。

object (BasicChartSpec)

基本图表规范，可以是多种图表之一。如需查看此 API 支持的所有图表的列表，请参阅 BasicChartType。

object (PieChartSpec)

饼图规范。

object (BubbleChartSpec)

气泡图规范。

object (CandlestickChartSpec)

K 线图规范。

object (OrgChartSpec)

组织结构图规范。

object (HistogramChartSpec)

直方图规范。

object (WaterfallChartSpec)

瀑布图规范。

object (TreemapChartSpec)

树形图规范。

object (ScorecardChartSpec)

统计信息摘要图表规范。

enum (HorizontalAlign)

相应文本的水平对齐方式设置。

string

与图表关联的数据源的 ID。

object (DataExecutionStatus)

仅限输出。数据执行状态。

enum (BasicChartType)

图表的类型。

enum (BasicChartLegendPosition)

图表图例的位置。

object (BasicChartAxis)

图表上的轴。

object (BasicChartDomain)

此图表所绘制数据的领域。仅支持单个网域。

object (BasicChartSeries)

此图表所直观呈现的数据。

integer

数据中“标题”的行数或列数。如果未设置，Google 表格会根据数据来推断标题的行数。

（请注意，BasicChartAxis.title 可能会替换从标题值推断出的轴标题。）

boolean

设为 True 可将图表设为 3D 图表。适用于柱形图和柱状图。

boolean

如果系列中缺少某些值，图表中可能会出现缺口（例如，折线图中会缺少线段）。如需消除这些空白，请将此值设置为 true。适用于折线图、面积图和组合图表。

enum (BasicChartStackedType)

适用于支持垂直堆叠的图表的堆叠类型。适用于面积图、条形图、柱形图、组合图和阶梯面积图。

boolean

获取默认情况下应将所有线条渲染为平滑还是直线。适用于折线图。

enum (BasicChartCompareMode)

在数据和图表区域上方悬停时，提示和数据突出显示的行为。

object (DataLabel)

用于控制是否在堆叠图表中显示额外的数据标签，这些标签会对域轴上每个值的所有堆叠值进行求和。只有当 chartType 为 AREA、BAR、COLUMN、COMBO 或 STEPPED_AREA 之一，且 stackedType 为 STACKED 或 PERCENT_STACKED 时，才能设置这些数据标签。此外，对于 COMBO，只有在只有一种可堆叠系列 type 或一种系列比其他系列多，并且其他每个系列不超过一个系列时，才支持此功能。例如，如果图表包含两个堆叠条形系列和一个面积系列，则支持总数据标签。如果图表包含三个条形系列和两个面积系列，则不允许使用总数据标签。不能在 totalDataLabel 上设置 CUSTOM 或 placement。

enum (BasicChartAxisPosition)

此轴的位置。

string

此轴的标题。如果设置了此属性，则会覆盖从数据标题推断出的任何标题。

object (TextFormat)

影视内容的格式。仅当轴未与网域相关联时才有效。不支持链接字段。

object (TextPosition)

轴标题文本的位置。

object (ChartAxisViewWindowOptions)

此轴的视图窗口选项。

number

此视图窗口中显示的最低数值。如果未设置，则会自动确定适合数据的最小值。

number

此视图窗口中显示的最大数值。如果未设置，系统会自动确定适合数据的上限值。

enum (ViewWindowMode)

视图窗口的模式。

object (ChartData)

网域的数据。例如，如果绘制一段时间内的股票价格图表，则此数据表示日期。

boolean

设为 true 可将域值（横轴）的顺序反转。

object (ChartGroupRule)

根据 ChartData 是否支持数据源图表的网域对数据进行分组的规则。仅适用于数据源图表。

enum (ChartAggregateType)

数据源图表系列的汇总类型。仅适用于数据源图表。

object (ChartSourceRange)

数据的来源范围。

object (DataSourceColumnReference)

对数据读取的数据源列的引用。

object (GridRange)

系列或网域的数据范围。其中必须有一个维度的长度为 1，并且列表中的所有来源都必须具有长度为 1 的相同维度。网域（如果有）和所有系列必须具有相同数量的来源范围。如果使用多个来源范围，则给定偏移处的来源范围必须在域和系列中保持顺序且连续。

例如，以下配置有效：

domain sources: A1:A5
series1 sources: B1:B5
series2 sources: D6:D10

domain sources: A1:A5, C10:C12
series1 sources: B1:B5, D10:D12
series2 sources: C1:C5, E10:E12

object (ChartDateTimeRule)

ChartDateTimeRule。

object (ChartHistogramRule)

ChartHistogramRule

enum (ChartDateTimeRuleType)

要应用的日期时间分组类型。

number

将项放入分桶时所需的最小值。小于下限的值会归为一组。如果省略，则由最低商品价值决定。

number

将项放入存储分区的最大值。大于上限的值会归为一组。如果省略，则由商品价值上限决定。

number

创建的存储分区的大小。必须为正值。

object (ChartData)

此图表系列中可视化的数据。

enum (BasicChartAxisPosition)

用于指定此系列的值范围的小轴。例如，如果绘制一段时间内的股票图表，则可能需要将“成交量”系列固定在右侧，并将价格固定在左侧，因为成交量的规模与价格的规模不同。如果指定的轴不是图表的 type 的有效副轴，则会出错。

enum (BasicChartType)

此系列的类型。仅当 chartType 为 COMBO 时有效。不同类型会改变系列图表的显示方式。仅支持 LINE、AREA 和 COLUMN。

object (LineStyle)

此系列的线条样式。仅当 chartType 为 AREA、LINE 或 SCATTER 时有效。 如果 series chart type 为 AREA 或 LINE，则也支持 COMBO 图表。

object (DataLabel)

此系列数据标签的相关信息。

object (Color)

与此系列相关联的元素（例如条形、线条和数据点）的颜色。如果为空，则使用默认颜色。已废弃：请使用 colorStyle。

object (ColorStyle)

与此系列相关联的元素（例如条形、线条和数据点）的颜色。如果为空，则使用默认颜色。如果同时设置了 color，则此字段优先。

object (PointStyle)

与此系列相关联的点的样式。仅当 chartType 为 AREA、LINE 或 SCATTER 时有效。 如果 series chart type 为 AREA、LINE 或 SCATTER，则也支持 COMBO 图表。如果为空，则使用默认的点样式。

object (BasicSeriesDataPointStyleOverride)

系列数据点的样式替换设置。

integer

线条的粗细（以像素为单位）。

enum (LineDashType)

线条的虚线类型。

enum (DataLabelType)

数据标签的类型。

object (TextFormat)

数据标签使用的文本格式。不支持链接字段。

enum (DataLabelPlacement)

数据标签相对于标记数据的位置。

object (ChartData)

要用于自定义标签的数据。仅当 type 设置为 CUSTOM 时才会使用。此数据的长度必须与此数据标签应用到的系列或其他元素的长度相同。此外，如果系列被拆分为多个来源范围，则此来源数据必须来自来源数据中的下一个列。例如，如果系列为 B2:B4,E6:E8，则这些数据必须来自 C2:C4,F6:F8。

number

数据点大小。如果为空，则使用默认大小。

enum (PointShape)

数据点形状。如果为空或未指定，则使用默认形状。

integer

系列数据点的索引（从零开始）。

object (Color)

系列数据点的颜色。如果为空，则使用系列默认值。已废弃：请使用 colorStyle。

object (ColorStyle)

系列数据点的颜色。如果为空，则使用系列默认值。如果同时设置了 color，则此字段优先。

object (PointStyle)

系列数据点的点样式。仅当 chartType 为 AREA、LINE 或 SCATTER 时有效。 如果 series chart type 为 AREA、LINE 或 SCATTER，则也支持 COMBO 图表。如果为空，则使用系列默认值。

enum (PieChartLegendPosition)

应绘制饼图图例的位置。

object (ChartData)

涵盖饼图领域的数据。

object (ChartData)

涵盖饼图中唯一系列的数据。

boolean

如果饼图是三维的，则为 True。

number

饼图中圆洞的大小。

enum (BubbleChartLegendPosition)

图表图例应绘制的位置。

object (ChartData)

包含气泡标签的数据。这些值不必是唯一的。

object (ChartData)

包含气泡 x 值的数据。这些值用于在图表中水平定位气泡。

object (ChartData)

包含气泡 y 值的数据。这些值用于垂直定位图表中的气泡。

object (ChartData)

包含气泡组 ID 的数据。具有相同组 ID 的所有气泡均以相同的颜色绘制。如果指定了 bubbleSizes，则还必须指定此字段，但可以包含空值。此字段是可选字段。

object (ChartData)

包含气泡大小的数据。气泡大小用于绘制彼此相对的不同大小的气泡。如果指定了该字段，则还必须指定 groupIds。此字段是可选字段。

number

气泡的不透明度，介于 0 到 1.0 之间。0 表示完全透明，1 表示完全不透明。

object (Color)

气泡边框颜色。已废弃：请使用 bubbleBorderColorStyle。

object (ColorStyle)

气泡边框颜色。如果同时设置了 bubbleBorderColor，则此字段优先。

integer

气泡的最大半径大小（以像素为单位）。如果指定，该字段必须为正值。

integer

气泡的最小半径大小（以像素为单位）。如果是具体值，该字段必须为正值。

object (TextFormat)

气泡内文本的格式。不支持删除线、下划线和链接。

object (CandlestickDomain)

烛形图的域数据（横轴）。字符串数据将被视为离散标签，其他数据将被视为连续值。

object (CandlestickData)

K 线图数据。仅支持一个 CandlestickData。

object (ChartData)

CandlestickDomain 的数据。

boolean

设为 true 可将域值（横轴）的顺序反转。

object (CandlestickSeries)

每个蜡烛图的低值/最小值的范围数据（垂直轴）。这是 K 线中轴线的底部。

object (CandlestickSeries)

每个蜡烛图的开盘价/初始值的范围数据（垂直轴）。这是实体烛体的底部。如果小于收盘价，则 K 线为实心，否则，蜡烛将是空心的。

object (CandlestickSeries)

每个蜡烛图的收盘价/最终值的范围数据（垂直轴）。这是实体烛体的顶部。如果大于开盘价，则 K 线为实心。否则，蜡烛将是空心的。

object (CandlestickSeries)

每个蜡烛图的最高值的范围数据（垂直轴）。这是 K 线上影线的最高点。

object (ChartData)

CandlestickSeries 的数据。

enum (OrgChartNodeSize)

组织架构节点的大小。

object (Color)

组织结构图节点的颜色。已废弃：请使用 nodeColorStyle。

object (ColorStyle)

组织结构图节点的颜色。如果同时设置了 nodeColor，则此字段优先。

object (Color)

所选组织结构图节点的颜色。已废弃：请使用 selectedNodeColorStyle。

object (ColorStyle)

所选组织结构图节点的颜色。如果同时设置了 selectedNodeColor，则此字段优先。

object (ChartData)

包含图表中所有节点的标签的数据。标签必须是唯一的。

object (ChartData)

包含相应节点父级标签的数据。空值表示该节点没有父级，是顶级节点。此字段是可选字段。

object (ChartData)

包含相应节点的提示的数据。如果值为空，系统将不会为节点显示任何提示。此字段是可选字段。

object (HistogramSeries)

直方图的系列可以是一系列要分桶的值，也可以是多个系列（每个系列的长度相同），其中包含系列名称，后跟要为该系列分桶的值。

enum (HistogramChartLegendPosition)

图表图例的位置。

boolean

是否应在每列中的项之间显示水平分隔线。

number

默认情况下，系统会自动选择分桶大小（单个列中堆叠的值的范围），但您可以在此处替换该大小。例如，如果存储分区大小为 1.5，则存储分区的范围为 0-1.5、1.5-3.0 等。不能为负数。此字段是可选字段。

number

离群值百分位数用于确保离群值不会对存储分区大小的计算产生不利影响。例如，如果将离群值百分位数设置为 0.05，则表示在计算分桶时，将排除 5% 的最高值和最低值。这些值仍会包含在图表中，但会添加到第一个或最后一个分桶中，而不是添加到自己的分桶中。必须介于 0.0 到 0.5 之间。

object (Color)

每个分桶中代表此系列的列的颜色。此字段是可选字段。已废弃：请使用 barColorStyle。

object (ColorStyle)

每个分桶中代表此系列的列的颜色。此字段是可选字段。如果同时设置了 barColor，则此字段优先。

object (ChartData)

此直方图系列的数据。

object (WaterfallChartDomain)

瀑布图的网域数据（横轴）。

object (WaterfallChartSeries)

此瀑布图所直观呈现的数据。

enum (WaterfallChartStackedType)

堆叠类型。

boolean

设为 true 以将第一个值解读为总计。

boolean

设置为 true 可隐藏列之间的连接线。

object (LineStyle)

连接线的线条样式。

object (DataLabel)

用于控制是否在堆叠图表中显示额外的数据标签，这些标签会对域轴上每个值的所有堆叠值进行求和。 stackedType 必须为 STACKED，并且不能在 totalDataLabel 上设置 CUSTOM 或 placement。

object (ChartData)

WaterfallChartDomain 的数据。

boolean

设为 true 可将域值（横轴）的顺序反转。

object (ChartData)

此系列中可视化的数据。

object (WaterfallChartColumnStyle)

此系列中所有值为正数的列的样式。

object (WaterfallChartColumnStyle)

此系列中所有负值列的样式。

object (WaterfallChartColumnStyle)

此系列中所有子总计列的样式。

boolean

设置为 True 可隐藏系列图表末尾的“小计”列。默认情况下，每个系列的末尾都会显示一个小计列。如果将此字段设置为 true，系统会隐藏此系列的此小计列。

object (WaterfallChartCustomSubtotal)

此系列中显示的自定义小计列。定义小计的顺序并不重要。每个数据点只能定义一个小计。

object (DataLabel)

此系列数据标签的相关信息。

string

列图例的标签。

object (Color)

列的颜色。已废弃：请使用 colorStyle。

object (ColorStyle)

列的颜色。如果同时设置了 color，则此字段优先。

integer

系列中数据点的索引（从零开始）。如果 dataIsSubtotal 为 true，则此编号对应的数据点为小计。否则，子总计会显示在此索引对应的数据点后面。系列可以在任意索引处包含多个小计，但小计不会影响数据点的索引。例如，如果某个系列有三个数据点，则无论该系列中有多少个子总计，或者这些子总计与哪些数据点相关联，它们的索引始终为 0、1 和 2。

string

小计列的标签。

boolean

如果 subtotalIndex 中的数据点是小计，则为 true。如果为 false，系统会计算小计并显示在数据点后面。

object (ChartData)

包含树状图单元格标签的数据。

object (ChartData)

包含树状图单元格的父标签的数据。

object (ChartData)

用于确定每个树形图数据单元格的大小的数据。此数据应为数字。系统不会渲染与非数字数据或缺失数据对应的单元格。如果未指定 colorData，系统还会使用此数据来确定数据单元格的背景颜色。

object (ChartData)

用于确定每个树状图数据单元格的背景颜色的数据。此字段是可选字段。如果未指定，则系统会使用 sizeData 来确定背景颜色。如果指定，数据应为数字。 colorScale将决定此数据中的值如何映射到数据单元格的背景颜色。

object (TextFormat)

图表上所有标签的文本格式。不支持链接字段。

integer

要在树状图图表中显示的数据级别数量。这些等级是互动的，并会显示其标签。如果未指定，则默认为 2。

integer

除了要在树状图表中显示的标记级别之外，其他数据级别的数量。这些等级不可互动，且在显示时不带标签。如果未指定，则默认为 0。

number

可能的最小数据值。值低于此值的单元格将与值等于此值的单元格具有相同的颜色。如果未指定，则默认为 colorData 中的实际最小值，如果未指定 colorData，则默认为 sizeData 中的最小值。

number

可能的最大数据值。值大于此值的单元格将与值等于此值的单元格具有相同的颜色。如果未指定，则默认为 colorData 中的实际最大值，如果未指定 colorData，则默认为 sizeData 中的最大值。

object (Color)

标题单元格的背景颜色。已废弃：请使用 headerColorStyle。

object (ColorStyle)

标题单元格的背景颜色。如果同时设置了 headerColor，则此字段优先。

object (TreemapChartColorScale)

树状图图表中数据单元格的颜色比例。系统会根据数据单元格的颜色值为其分配颜色。这些颜色值来自 colorData，如果未指定 colorData，则来自 sizeData。颜色值小于或等于 minValue 的单元格将采用 minValueColor 作为背景颜色。颜色值大于或等于 maxValue 的单元格的背景颜色为 maxValueColor。颜色值介于 minValue 和 maxValue 之间的单元格的背景颜色将介于 minValueColor 和 maxValueColor 之间的渐变色，渐变的中间点为 midValueColor。缺少颜色值或颜色值非数字的单元格的背景颜色将为 noDataColor。

boolean

设为 true 可隐藏提示。

object (Color)

颜色值小于或等于 minValue 的单元格的背景颜色。如果未指定，则默认为 #dc3912。已废弃：请使用 minValueColorStyle。

object (ColorStyle)

颜色值小于或等于 minValue 的单元格的背景颜色。如果未指定，则默认为 #dc3912。如果同时设置了 minValueColor，则此字段优先。

object (Color)

颜色值介于 minValue 和 maxValue 之间的单元格的背景颜色。如果未指定，则默认为 #efe6dc。已废弃：请使用 midValueColorStyle。

object (ColorStyle)

颜色值介于 minValue 和 maxValue 之间的单元格的背景颜色。如果未指定，则默认为 #efe6dc。如果同时设置了 midValueColor，则此字段优先。

object (Color)

颜色值大于或等于 maxValue 的单元格的背景颜色。如果未指定，则默认为 #109618。已废弃：请使用 maxValueColorStyle。

object (ColorStyle)

颜色值大于或等于 maxValue 的单元格的背景颜色。如果未指定，则默认为 #109618。如果同时设置了 maxValueColor，则此字段优先。

object (Color)

没有关联颜色数据的单元格的背景颜色。如果未指定，则默认为 #000000。已废弃：请使用 noDataColorStyle。

object (ColorStyle)

没有关联颜色数据的单元格的背景颜色。如果未指定，则默认为 #000000。如果同时设置了 noDataColor，则此字段优先。

object (ChartData)

计分卡键值对的数据。

object (ChartData)

统计信息摘要基准值的数据。此字段是可选字段。

enum (ChartAggregateType)

计分卡图表中关键图表数据和基准图表数据的汇总类型。数据源图表不支持此字段。对于数据源图表，请改用 keyValueData 或 baselineValueData 的 ChartData.aggregateType 字段。此字段是可选字段。

object (KeyValueFormat)

键值的格式设置选项。

object (BaselineValueFormat)

基准值的格式设置选项。只有在指定了 baselineValueData 时，才需要此字段。

number

用于缩放计分卡键值和基准值的值。例如，系数 10 可用于将图表中的所有值除以 10。此字段是可选字段。

enum (ChartNumberFormatSource)

计分卡图表中使用的数字格式来源。此字段是可选字段。

object (ChartCustomNumberFormatOptions)

统计信息摘要图表中数值键值/基准值的自定义格式设置选项。仅当 numberFormatSource 设置为 CUSTOM 时，才会使用此字段。此字段是可选字段。

object (TextFormat)

键值对的文本格式选项。不支持链接字段。

object (TextPosition)

指定键值的水平文本位置。此字段是可选字段。如果未指定，则使用默认定位。

enum (ComparisonType)

键值与基准值的比较类型。

object (TextFormat)

基准值的文本格式选项。不支持链接字段。

object (TextPosition)

指定基准值的水平文本位置。此字段是可选字段。如果未指定，则使用默认定位。

string

附加到基准值后面的说明。此字段是可选字段。

object (Color)

要使用的颜色，如果基准值表示键值的正变化。此字段是可选字段。已废弃：请使用 positiveColorStyle。

object (ColorStyle)

要使用的颜色，如果基准值表示键值的正变化。此字段是可选字段。如果同时设置了 positiveColor，则此字段优先。

object (Color)

要使用的颜色，如果基准值表示关键值的负值变化。此字段是可选字段。已废弃：请使用 negativeColorStyle。

object (ColorStyle)

要使用的颜色，如果基准值表示关键值的负值变化。此字段是可选字段。如果同时设置了 negativeColor，则此字段优先。

string

要附加到图表属性前面的自定义前缀。此字段是可选字段。

string

要附加到图表属性的自定义后缀。此字段是可选字段。

object (Color)

边框的颜色。已废弃：请使用 colorStyle。

object (ColorStyle)

边框的颜色。如果同时设置了 color，则此字段优先。