此页面由 Cloud Translation API 翻译。

Charts

EmbeddedChart

嵌入到工作表中的图表。

JSON 表示法
{ "chartId": integer, "spec": { object (`ChartSpec`) }, "position": { object (`EmbeddedObjectPosition`) }, "border": { object (`EmbeddedObjectBorder`) } }

字段
`chartId`	`integer` 图表的 ID。
`spec`	`object (ChartSpec)` 图表的规范。
`position`	`object (EmbeddedObjectPosition)` 图表的位置。
`border`	`object (EmbeddedObjectBorder)` 图表的边框。

ChartSpec

图表的规范。

JSON 表示法

JSON 表示法
{ "title": string, "altText": string, "titleTextFormat": { object (`TextFormat`) }, "titleTextPosition": { object (`TextPosition`) }, "subtitle": string, "subtitleTextFormat": { object (`TextFormat`) }, "subtitleTextPosition": { object (`TextPosition`) }, "fontName": string, "maximized": boolean, "backgroundColor": { object (`Color`) }, "backgroundColorStyle": { object (`ColorStyle`) }, "dataSourceChartProperties": { object (`DataSourceChartProperties`) }, "filterSpecs": [ { object (`FilterSpec`) } ], "sortSpecs": [ { object (`SortSpec`) } ], "hiddenDimensionStrategy": enum (`ChartHiddenDimensionStrategy`), // Union field `chart` can be only one of the following: "basicChart": { object (`BasicChartSpec`) }, "pieChart": { object (`PieChartSpec`) }, "bubbleChart": { object (`BubbleChartSpec`) }, "candlestickChart": { object (`CandlestickChartSpec`) }, "orgChart": { object (`OrgChartSpec`) }, "histogramChart": { object (`HistogramChartSpec`) }, "waterfallChart": { object (`WaterfallChartSpec`) }, "treemapChart": { object (`TreemapChartSpec`) }, "scorecardChart": { object (`ScorecardChartSpec`) } // End of list of possible types for union field `chart`. }

{
  "title": string,
  "altText": string,
  "titleTextFormat": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "subtitle": string,
  "subtitleTextFormat": {
    object (TextFormat)
  },
  "subtitleTextPosition": {
    object (TextPosition)
  },
  "fontName": string,
  "maximized": boolean,
  "backgroundColor": {
    object (Color)
  },
  "backgroundColorStyle": {
    object (ColorStyle)
  },
  "dataSourceChartProperties": {
    object (DataSourceChartProperties)
  },
  "filterSpecs": [
    {
      object (FilterSpec)
    }
  ],
  "sortSpecs": [
    {
      object (SortSpec)
    }
  ],
  "hiddenDimensionStrategy": enum (ChartHiddenDimensionStrategy),

  // Union field chart can be only one of the following:
  "basicChart": {
    object (BasicChartSpec)
  },
  "pieChart": {
    object (PieChartSpec)
  },
  "bubbleChart": {
    object (BubbleChartSpec)
  },
  "candlestickChart": {
    object (CandlestickChartSpec)
  },
  "orgChart": {
    object (OrgChartSpec)
  },
  "histogramChart": {
    object (HistogramChartSpec)
  },
  "waterfallChart": {
    object (WaterfallChartSpec)
  },
  "treemapChart": {
    object (TreemapChartSpec)
  },
  "scorecardChart": {
    object (ScorecardChartSpec)
  }
  // End of list of possible types for union field chart.
}

字段
`title`	`string` 图表的标题。
`altText`	`string` 用于描述图表的替代文本。这通常用于确保可访问性。
`titleTextFormat`	`object (TextFormat)` 标题文本格式。不支持删除线、下划线和链接。
`titleTextPosition`	`object (TextPosition)` 标题文本的位置。此字段是可选字段。
`subtitle`	`string` 图表的副标题。
`subtitleTextFormat`	`object (TextFormat)` 字幕文本格式。不支持删除线、下划线和链接。
`subtitleTextPosition`	`object (TextPosition)` 副标题文本位置。此字段是可选字段。
`fontName`	`string` 默认情况下用于所有图表文本（例如标题、轴标签、图例）的字体的名称。如果为图表的特定部分指定了字体，则该字体会替换此字体名称。
`maximized`	`boolean` 设置为 true 可使图表填充其呈现的整个空间，并尽可能减少内边距。设为 false 以使用默认内边距。（不适用于地理图表和组织结构图）。
`backgroundColor (deprecated)`	`object (Color)` 此项已弃用！整个图表的背景颜色。不适用于组织结构图。已废弃：请使用 `backgroundColorStyle`。
`backgroundColorStyle`	`object (ColorStyle)` 整个图表的背景颜色。不适用于组织结构图。如果同时设置了 `backgroundColor`，则此字段优先。
`dataSourceChartProperties`	`object (DataSourceChartProperties)` 如果存在，该字段包含数据源图表专用属性。
`filterSpecs[]`	`object (FilterSpec)` 应用于图表源数据的过滤条件。仅适用于数据源图表。
`sortSpecs[]`	`object (SortSpec)` 用于对图表数据进行排序的顺序。仅支持单个排序规范。仅适用于数据源图表。
`hiddenDimensionStrategy`	`enum (ChartHiddenDimensionStrategy)` 确定图表将如何使用隐藏的行或列。
联合字段 `chart`。具体图表规范，必须设置一个值。 `chart`只能是以下其中一项：
`basicChart`	`object (BasicChartSpec)` 基本图表规范，可以是多种图表之一。如需查看此 API 支持的所有图表的列表，请参阅 `BasicChartType`。
`pieChart`	`object (PieChartSpec)` 饼图规范。
`bubbleChart`	`object (BubbleChartSpec)` 气泡图规范。
`candlestickChart`	`object (CandlestickChartSpec)` K 线图规范。
`orgChart`	`object (OrgChartSpec)` 组织结构图规范。
`histogramChart`	`object (HistogramChartSpec)` 直方图规范。
`waterfallChart`	`object (WaterfallChartSpec)` 瀑布图规范。
`treemapChart`	`object (TreemapChartSpec)` 树形图规范。
`scorecardChart`	`object (ScorecardChartSpec)` 统计信息摘要图表规范。

TextPosition

文本的位置设置。

JSON 表示法
{ "horizontalAlignment": enum (`HorizontalAlign`) }

字段

字段
`horizontalAlignment`	`enum (HorizontalAlign)` 相应文本的水平对齐方式设置。

horizontalAlignment

enum (HorizontalAlign)

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

DataSourceChartProperties

数据源图表的属性。

JSON 表示法
{ "dataSourceId": string, "dataExecutionStatus": { object (`DataExecutionStatus`) } }

字段

字段
`dataSourceId`	`string` 与图表关联的数据源的 ID。
`dataExecutionStatus`	`object (DataExecutionStatus)` 仅限输出。数据执行状态。

dataSourceId

string

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

dataExecutionStatus

object (DataExecutionStatus)

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

BasicChartSpec

基本图表的规范。如需查看此 API 支持的图表列表，请参阅 BasicChartType。

JSON 表示法

JSON 表示法
{ "chartType": enum (`BasicChartType`), "legendPosition": enum (`BasicChartLegendPosition`), "axis": [ { object (`BasicChartAxis`) } ], "domains": [ { object (`BasicChartDomain`) } ], "series": [ { object (`BasicChartSeries`) } ], "headerCount": integer, "threeDimensional": boolean, "interpolateNulls": boolean, "stackedType": enum (`BasicChartStackedType`), "lineSmoothing": boolean, "compareMode": enum (`BasicChartCompareMode`), "totalDataLabel": { object (`DataLabel`) } }

{
  "chartType": enum (BasicChartType),
  "legendPosition": enum (BasicChartLegendPosition),
  "axis": [
    {
      object (BasicChartAxis)
    }
  ],
  "domains": [
    {
      object (BasicChartDomain)
    }
  ],
  "series": [
    {
      object (BasicChartSeries)
    }
  ],
  "headerCount": integer,
  "threeDimensional": boolean,
  "interpolateNulls": boolean,
  "stackedType": enum (BasicChartStackedType),
  "lineSmoothing": boolean,
  "compareMode": enum (BasicChartCompareMode),
  "totalDataLabel": {
    object (DataLabel)
  }
}

字段
`chartType`	`enum (BasicChartType)` 图表的类型。
`legendPosition`	`enum (BasicChartLegendPosition)` 图表图例的位置。
`axis[]`	`object (BasicChartAxis)` 图表上的轴。
`domains[]`	`object (BasicChartDomain)` 此图表所绘制数据的领域。仅支持单个网域。
`series[]`	`object (BasicChartSeries)` 此图表所直观呈现的数据。
`headerCount`	`integer` 数据中“标题”的行数或列数。如果未设置，Google 表格会根据数据来推断标题的行数。（请注意，`BasicChartAxis.title` 可能会替换从标题值推断出的轴标题。）
`threeDimensional`	`boolean` 设为 True 可将图表设为 3D 图表。适用于柱形图和柱状图。
`interpolateNulls`	`boolean` 如果系列中缺少某些值，图表中可能会出现缺口（例如，折线图中会缺少线段）。如需消除这些空白，请将此值设置为 true。适用于折线图、面积图和组合图表。
`stackedType`	`enum (BasicChartStackedType)` 适用于支持垂直堆叠的图表的堆叠类型。适用于面积图、条形图、柱形图、组合图和阶梯面积图。
`lineSmoothing`	`boolean` 获取默认情况下应将所有线条渲染为平滑还是直线。适用于折线图。
`compareMode`	`enum (BasicChartCompareMode)` 在数据和图表区域上方悬停时，提示和数据突出显示的行为。
`totalDataLabel`	`object (DataLabel)` 用于控制是否在堆叠图表中显示额外的数据标签，这些标签会对域轴上每个值的所有堆叠值进行求和。只有当 `chartType` 为 `AREA`、`BAR`、`COLUMN`、`COMBO` 或 `STEPPED_AREA` 之一，且 `stackedType` 为 `STACKED` 或 `PERCENT_STACKED` 时，才能设置这些数据标签。此外，对于 `COMBO`，只有在只有一种可堆叠系列 `type` 或一种系列比其他系列多，并且其他每个系列不超过一个系列时，才支持此功能。例如，如果图表包含两个堆叠条形系列和一个面积系列，则支持总数据标签。如果图表包含三个条形系列和两个面积系列，则不允许使用总数据标签。不能在 `totalDataLabel` 上设置 `CUSTOM` 或 `placement`。

BasicChartType

图表的直观呈现方式。

枚举
`BASIC_CHART_TYPE_UNSPECIFIED`	默认值，请勿使用。
`BAR`	条形图。
`LINE`	折线图。
`AREA`	面积图。
`COLUMN`	柱形图。
`SCATTER`	散点图。
`COMBO`	组合图表。
`STEPPED_AREA`	阶梯面积图。

BasicChartLegendPosition

图表图例应放置的位置。

枚举
`BASIC_CHART_LEGEND_POSITION_UNSPECIFIED`	默认值，请勿使用。
`BOTTOM_LEGEND`	图例会渲染在图表底部。
`LEFT_LEGEND`	图例会渲染在图表的左侧。
`RIGHT_LEGEND`	图例会渲染在图表右侧。
`TOP_LEGEND`	图例会呈现在图表顶部。
`NO_LEGEND`	系统不会渲染图例。

BasicChartAxis

图表的轴。一个图表中每个 axis position 不得有多个轴。

JSON 表示法

JSON 表示法
{ "position": enum (`BasicChartAxisPosition`), "title": string, "format": { object (`TextFormat`) }, "titleTextPosition": { object (`TextPosition`) }, "viewWindowOptions": { object (`ChartAxisViewWindowOptions`) } }

{
  "position": enum (BasicChartAxisPosition),
  "title": string,
  "format": {
    object (TextFormat)
  },
  "titleTextPosition": {
    object (TextPosition)
  },
  "viewWindowOptions": {
    object (ChartAxisViewWindowOptions)
  }
}

字段
`position`	`enum (BasicChartAxisPosition)` 此轴的位置。
`title`	`string` 此轴的标题。如果设置了此属性，则会覆盖从数据标题推断出的任何标题。
`format`	`object (TextFormat)` 影视内容的格式。仅当轴未与网域相关联时才有效。不支持链接字段。
`titleTextPosition`	`object (TextPosition)` 轴标题文本的位置。
`viewWindowOptions`	`object (ChartAxisViewWindowOptions)` 此轴的视图窗口选项。

BasicChartAxisPosition

图表轴的位置。

枚举
`BASIC_CHART_AXIS_POSITION_UNSPECIFIED`	默认值，请勿使用。
`BOTTOM_AXIS`	在图表底部呈现的轴。对于大多数图表，这是标准的主轴。对于条形图，这是辅助轴。
`LEFT_AXIS`	在图表左侧呈现的轴。对于大多数图表，这是辅助轴。对于条形图，这是标准的主轴。
`RIGHT_AXIS`	在图表右侧呈现的轴。对于大多数图表，这是辅助轴。对于条形图，这是不寻常的主轴。

ChartAxisViewWindowOptions

用于定义图表“视图窗口”（例如轴中的可见值）的选项。

JSON 表示法
{ "viewWindowMin": number, "viewWindowMax": number, "viewWindowMode": enum (`ViewWindowMode`) }

字段

字段
`viewWindowMin`	`number` 此视图窗口中显示的最低数值。如果未设置，则会自动确定适合数据的最小值。
`viewWindowMax`	`number` 此视图窗口中显示的最大数值。如果未设置，系统会自动确定适合数据的上限值。
`viewWindowMode`	`enum (ViewWindowMode)` 视图窗口的模式。

viewWindowMin

number

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

viewWindowMax

number

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

viewWindowMode

enum (ViewWindowMode)

视图窗口的模式。

ViewWindowMode

视图窗口的模式。它定义了如何处理视图窗口的最小值和最大值。

枚举
`DEFAULT_VIEW_WINDOW_MODE`	Google 表格编辑器中用于此图表类型的默认视图窗口模式。在大多数情况下，如果设置了默认模式，则该模式等同于 `PRETTY`。
`VIEW_WINDOW_MODE_UNSUPPORTED`	请勿使用。表示 API 不支持当前设置的模式。
`EXPLICIT`	严格遵循最小值和最大值（如果指定）。如果未指定值，则会回退到 `PRETTY` 值。
`PRETTY`	选择能让图表看起来美观的最小值和最大值。在此模式下，系统会忽略最小值和最大值。

BasicChartDomain

图表的域名。例如，如果绘制一段时间内的股票价格图表，则此维度就是日期。

JSON 表示法
{ "domain": { object (`ChartData`) }, "reversed": boolean }

字段

字段
`domain`	`object (ChartData)` 网域的数据。例如，如果绘制一段时间内的股票价格图表，则此数据表示日期。
`reversed`	`boolean` 设为 true 可将域值（横轴）的顺序反转。

domain

object (ChartData)

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

reversed

boolean

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

ChartData

网域或系列中包含的数据。

JSON 表示法

JSON 表示法
{ "groupRule": { object (`ChartGroupRule`) }, "aggregateType": enum (`ChartAggregateType`), // Union field `type` can be only one of the following: "sourceRange": { object (`ChartSourceRange`) }, "columnReference": { object (`DataSourceColumnReference`) } // End of list of possible types for union field `type`. }

{
  "groupRule": {
    object (ChartGroupRule)
  },
  "aggregateType": enum (ChartAggregateType),

  // Union field type can be only one of the following:
  "sourceRange": {
    object (ChartSourceRange)
  },
  "columnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field type.
}

字段
`groupRule`	`object (ChartGroupRule)` 根据 ChartData 是否支持数据源图表的网域对数据进行分组的规则。仅适用于数据源图表。
`aggregateType`	`enum (ChartAggregateType)` 数据源图表系列的汇总类型。仅适用于数据源图表。
联合字段 `type`。包含的数据类型，必须设置一个值。 `type`只能是以下其中一项：
`sourceRange`	`object (ChartSourceRange)` 数据的来源范围。
`columnReference`	`object (DataSourceColumnReference)` 对数据读取的数据源列的引用。

ChartSourceRange

图表的来源范围。

JSON 表示法
{ "sources": [ { object (`GridRange`) } ] }

字段

字段
`sources[]`	`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`

sources[]

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

ChartGroupRule

数据源图表的域的 ChartData 上的可选设置，用于为域中的值定义分桶，而不是对每个单独的值进行细分。

例如，绘制数据源图表时，您可以针对网域（应仅包含数值）指定直方图规则，将其值划分到多个分桶中。图表系列中属于同一分桶的所有值都会基于 aggregateType 进行汇总。

JSON 表示法

JSON 表示法
{ // Union field `rule` can be only one of the following: "dateTimeRule": { object (`ChartDateTimeRule`) }, "histogramRule": { object (`ChartHistogramRule`) } // End of list of possible types for union field `rule`. }

{

  // Union field rule can be only one of the following:
  "dateTimeRule": {
    object (ChartDateTimeRule)
  },
  "histogramRule": {
    object (ChartHistogramRule)
  }
  // End of list of possible types for union field rule.
}

字段

字段
联合字段 `rule`。要应用于 `ChartData` 的规则。 `rule`只能是以下其中一项：
`dateTimeRule`	`object (ChartDateTimeRule)` `ChartDateTimeRule`。
`histogramRule`	`object (ChartHistogramRule)` `ChartHistogramRule`

联合字段 rule。要应用于 ChartData 的规则。 rule只能是以下其中一项：

dateTimeRule

object (ChartDateTimeRule)

ChartDateTimeRule。

histogramRule

object (ChartHistogramRule)

ChartHistogramRule

ChartDateTimeRule

让您能够根据日期或时间值的选定部分，将源数据列中的日期时间值整理到多个存储分区中。

JSON 表示法
{ "type": enum (`ChartDateTimeRuleType`) }

字段

字段
`type`	`enum (ChartDateTimeRuleType)` 要应用的日期时间分组类型。

type

enum (ChartDateTimeRuleType)

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

ChartDateTimeRuleType

可用的日期时间分组规则类型。

枚举
`CHART_DATE_TIME_RULE_TYPE_UNSPECIFIED`	默认类型，请勿使用。
`SECOND`	按秒（从 0 到 59）对日期进行分组。
`MINUTE`	按分钟（从 0 到 59）对日期进行分组。
`HOUR`	使用 24 小时制（从 0 到 23）按小时对日期进行分组。
`HOUR_MINUTE`	使用 24 小时制按小时和分钟对日期进行分组，例如 19:45。
`HOUR_MINUTE_AMPM`	使用 12 小时制按小时和分钟对日期进行分组，例如晚上 7:45。上午/下午标识会根据电子表格的语言区域进行翻译。
`DAY_OF_WEEK`	按星期对日期进行分组，例如星期日。星期几将根据电子表格的语言区域进行翻译。
`DAY_OF_YEAR`	按一年中的日期（从 1 到 366）对日期进行分组。请注意，2 月 29 日之后的日期在闰年和非闰年中的分桶不同。
`DAY_OF_MONTH`	按日期（从 1 到 31 的日期）对日期进行分组。
`DAY_MONTH`	按日期和月份对日期进行分组，例如 11 月 22 日。月份会根据电子表格的语言区域进行翻译。
`MONTH`	按月份对日期进行分组，例如 11 月。月份会根据电子表格的语言区域进行翻译。
`QUARTER`	按季度对日期进行分组，例如第 1 季度（表示 1 月至 3 月）。
`YEAR`	按年份对日期进行分组，例如 2008 年。
`YEAR_MONTH`	按年份和月份对日期进行分组，例如 2008 年 11 月。月份会根据电子表格的语言区域进行翻译。
`YEAR_QUARTER`	按年份和季度对日期进行分组，例如 2008 第 4 季度。
`YEAR_MONTH_DAY`	按年、月和日对日期进行分组，例如 2008-11-22。

ChartHistogramRule

可让您将来源数据列中的数值整理到大小不变的分桶中。

JSON 表示法
{ "minValue": number, "maxValue": number, "intervalSize": number }

字段

字段
`minValue`	`number` 将项放入分桶时所需的最小值。小于下限的值会归为一组。如果省略，则由最低商品价值决定。
`maxValue`	`number` 将项放入存储分区的最大值。大于上限的值会归为一组。如果省略，则由商品价值上限决定。
`intervalSize`	`number` 创建的存储分区的大小。必须为正值。

minValue

number

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

maxValue

number

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

intervalSize

number

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

ChartAggregateType

图表系列的汇总类型。

枚举
`CHART_AGGREGATE_TYPE_UNSPECIFIED`	默认值，请勿使用。
`AVERAGE`	平均汇总函数。
`COUNT`	计数汇总函数。
`MAX`	最大值汇总函数。
`MEDIAN`	中位数汇总函数。
`MIN`	最基本的汇总函数。
`SUM`	求和汇总函数。

BasicChartSeries

图表中的一个数据系列。例如，如果绘制一段时间内的股票价格图表，则可能存在多个系列，分别对应“开盘价”“最高价”“最低价”和“收盘价”。

JSON 表示法

JSON 表示法
{ "series": { object (`ChartData`) }, "targetAxis": enum (`BasicChartAxisPosition`), "type": enum (`BasicChartType`), "lineStyle": { object (`LineStyle`) }, "dataLabel": { object (`DataLabel`) }, "color": { object (`Color`) }, "colorStyle": { object (`ColorStyle`) }, "pointStyle": { object (`PointStyle`) }, "styleOverrides": [ { object (`BasicSeriesDataPointStyleOverride`) } ] }

{
  "series": {
    object (ChartData)
  },
  "targetAxis": enum (BasicChartAxisPosition),
  "type": enum (BasicChartType),
  "lineStyle": {
    object (LineStyle)
  },
  "dataLabel": {
    object (DataLabel)
  },
  "color": {
    object (Color)
  },
  "colorStyle": {
    object (ColorStyle)
  },
  "pointStyle": {
    object (PointStyle)
  },
  "styleOverrides": [
    {
      object (BasicSeriesDataPointStyleOverride)
    }
  ]
}

字段
`series`	`object (ChartData)` 此图表系列中可视化的数据。
`targetAxis`	`enum (BasicChartAxisPosition)` 用于指定此系列的值范围的小轴。例如，如果绘制一段时间内的股票图表，则可能需要将“成交量”系列固定在右侧，并将价格固定在左侧，因为成交量的规模与价格的规模不同。如果指定的轴不是图表的 `type` 的有效副轴，则会出错。
`type`	`enum (BasicChartType)` 此系列的类型。仅当 `chartType` 为 `COMBO` 时有效。不同类型会改变系列图表的显示方式。仅支持 `LINE`、`AREA` 和 `COLUMN`。
`lineStyle`	`object (LineStyle)` 此系列的线条样式。仅当 `chartType` 为 `AREA`、`LINE` 或 `SCATTER` 时有效。如果 `series chart type` 为 `AREA` 或 `LINE`，则也支持 `COMBO` 图表。
`dataLabel`	`object (DataLabel)` 此系列数据标签的相关信息。
`color (deprecated)`	`object (Color)` 此项已弃用！与此系列相关联的元素（例如条形、线条和数据点）的颜色。如果为空，则使用默认颜色。已废弃：请使用 `colorStyle`。
`colorStyle`	`object (ColorStyle)` 与此系列相关联的元素（例如条形、线条和数据点）的颜色。如果为空，则使用默认颜色。如果同时设置了 `color`，则此字段优先。
`pointStyle`	`object (PointStyle)` 与此系列相关联的点的样式。仅当 `chartType` 为 `AREA`、`LINE` 或 `SCATTER` 时有效。如果 `series chart type` 为 `AREA`、`LINE` 或 `SCATTER`，则也支持 `COMBO` 图表。如果为空，则使用默认的点样式。
`styleOverrides[]`	`object (BasicSeriesDataPointStyleOverride)` 系列数据点的样式替换设置。

LineStyle

用于描述线条样式的属性。

JSON 表示法
{ "width": integer, "type": enum (`LineDashType`) }

字段

字段
`width`	`integer` 线条的粗细（以像素为单位）。
`type`	`enum (LineDashType)` 线条的虚线类型。

width

integer

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

type

enum (LineDashType)

线条的虚线类型。

LineDashType

线条的虚线类型。

枚举
`LINE_DASH_TYPE_UNSPECIFIED`	默认值，请勿使用。
`INVISIBLE`	无虚线类型，相当于不可见的线条。
`CUSTOM`	线条的自定义虚线。目前不支持修改确切的自定义虚线样式。
`SOLID`	实线。
`DOTTED`	虚线。
`MEDIUM_DASHED`	虚线，虚线的长度为“中”。
`MEDIUM_DASHED_DOTTED`	线条，交替使用“中等”短划线和圆点。
`LONG_DASHED`	虚线，虚线的长度为“长”。
`LONG_DASHED_DOTTED`	线条，交替显示“长”短划线和圆点。

DataLabel

一组数据标签的设置。数据标签是显示在一系列数据（例如折线图上的数据点）旁边的注释，可提供有关数据所代表内容的其他信息，例如图表上该数据点后面的值的文本表示法。

JSON 表示法
{ "type": enum (`DataLabelType`), "textFormat": { object (`TextFormat`) }, "placement": enum (`DataLabelPlacement`), "customLabelData": { object (`ChartData`) } }

字段
`type`	`enum (DataLabelType)` 数据标签的类型。
`textFormat`	`object (TextFormat)` 数据标签使用的文本格式。不支持链接字段。
`placement`	`enum (DataLabelPlacement)` 数据标签相对于标记数据的位置。
`customLabelData`	`object (ChartData)` 要用于自定义标签的数据。仅当 `type` 设置为 `CUSTOM` 时才会使用。此数据的长度必须与此数据标签应用到的系列或其他元素的长度相同。此外，如果系列被拆分为多个来源范围，则此来源数据必须来自来源数据中的下一个列。例如，如果系列为 B2:B4,E6:E8，则这些数据必须来自 C2:C4,F6:F8。

DataLabelType

数据标签的类型。

枚举
`DATA_LABEL_TYPE_UNSPECIFIED`	未指定数据标签类型，系统会根据图表中数据标签的上下文进行解读。
`NONE`	系统不会显示数据标签。
`DATA`	数据标签使用系列数据中的值进行显示。
`CUSTOM`	数据标签使用 `customLabelData` 指示的自定义数据源中的值进行显示。

DataLabelPlacement

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

枚举
`DATA_LABEL_PLACEMENT_UNSPECIFIED`	呈现位置由渲染程序自动确定。
`CENTER`	在水平和垂直方向上居中显示在条或列中。
`LEFT`	位于数据点左侧。
`RIGHT`	位于数据点的右侧。
`ABOVE`	在数据点上方。
`BELOW`	数据点下方。
`INSIDE_END`	位于条或列的底部（如果为正值，则位于顶部；如果为负值，则位于底部）。
`INSIDE_BASE`	位于底部的条或列内。
`OUTSIDE_END`	位于条状标签或列的末尾外侧。

PointStyle

图表上点的样式。

JSON 表示法
{ "size": number, "shape": enum (`PointShape`) }

字段

字段
`size`	`number` 数据点大小。如果为空，则使用默认大小。
`shape`	`enum (PointShape)` 数据点形状。如果为空或未指定，则使用默认形状。

size

number

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

shape

enum (PointShape)

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

PointShape

点的形状。

枚举
`POINT_SHAPE_UNSPECIFIED`	默认值。
`CIRCLE`	圆形。
`DIAMOND`	菱形。
`HEXAGON`	六边形。
`PENTAGON`	五边形。
`SQUARE`	方形。
`STAR`	星形。
`TRIANGLE`	三角形。
`X_MARK`	X 形标记。

BasicSeriesDataPointStyleOverride

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

JSON 表示法
{ "index": integer, "color": { object (`Color`) }, "colorStyle": { object (`ColorStyle`) }, "pointStyle": { object (`PointStyle`) } }

字段
`index`	`integer` 系列数据点的索引（从零开始）。
`color (deprecated)`	`object (Color)` 此项已弃用！系列数据点的颜色。如果为空，则使用系列默认值。已废弃：请使用 `colorStyle`。
`colorStyle`	`object (ColorStyle)` 系列数据点的颜色。如果为空，则使用系列默认值。如果同时设置了 `color`，则此字段优先。
`pointStyle`	`object (PointStyle)` 系列数据点的点样式。仅当 `chartType` 为 `AREA`、`LINE` 或 `SCATTER` 时有效。如果 `series chart type` 为 `AREA`、`LINE` 或 `SCATTER`，则也支持 `COMBO` 图表。如果为空，则使用系列默认值。

BasicChartStackedType

堆叠图表时，范围（垂直轴）值会叠加显示，而不是从水平轴显示。例如，两个值 20 和 80 将从 0 开始绘制，其中 80 距离水平轴 80 个单位。如果它们是堆叠的，则 80 会从 20 开始渲染，并将其放置在距离水平轴 100 个单位的位置。

枚举
`BASIC_CHART_STACKED_TYPE_UNSPECIFIED`	默认值，请勿使用。
`NOT_STACKED`	系列图表不会堆叠。
`STACKED`	系列值会堆叠显示，每个值从其下方值的顶部开始垂直呈现。
`PERCENT_STACKED`	垂直堆叠会延伸到图表顶部，值以彼此的百分比形式显示。

BasicChartCompareMode

比较模式类型，用于描述在悬停在数据和图表区域上时，提示和数据突出显示的行为。

枚举
`BASIC_CHART_COMPARE_MODE_UNSPECIFIED`	默认值，请勿使用。
`DATUM`	只有聚焦的数据元素会突出显示并显示在提示中。
`CATEGORY`	系统会突出显示所有具有相同类别（例如网域值）的数据元素，并将其显示在提示中。

PieChartSpec

饼图。

JSON 表示法
{ "legendPosition": enum (`PieChartLegendPosition`), "domain": { object (`ChartData`) }, "series": { object (`ChartData`) }, "threeDimensional": boolean, "pieHole": number }

字段
`legendPosition`	`enum (PieChartLegendPosition)` 应绘制饼图图例的位置。
`domain`	`object (ChartData)` 涵盖饼图领域的数据。
`series`	`object (ChartData)` 涵盖饼图中唯一系列的数据。
`threeDimensional`	`boolean` 如果饼图是三维的，则为 True。
`pieHole`	`number` 饼图中圆洞的大小。

PieChartLegendPosition

图表图例应放置的位置。

枚举
`PIE_CHART_LEGEND_POSITION_UNSPECIFIED`	默认值，请勿使用。
`BOTTOM_LEGEND`	图例会渲染在图表底部。
`LEFT_LEGEND`	图例会渲染在图表的左侧。
`RIGHT_LEGEND`	图例会渲染在图表右侧。
`TOP_LEGEND`	图例会呈现在图表顶部。
`NO_LEGEND`	系统不会渲染图例。
`LABELED_LEGEND`	每个饼状图块都附带一个标签。

BubbleChartSpec

气泡图。

JSON 表示法

{
  "legendPosition": enum (BubbleChartLegendPosition),
  "bubbleLabels": {
    object (ChartData)
  },
  "domain": {
    object (ChartData)
  },
  "series": {
    object (ChartData)
  },
  "groupIds": {
    object (ChartData)
  },
  "bubbleSizes": {
    object (ChartData)
  },
  "bubbleOpacity": number,
  "bubbleBorderColor": {
    object (Color)
  },
  "bubbleBorderColorStyle": {
    object (ColorStyle)
  },
  "bubbleMaxRadiusSize": integer,
  "bubbleMinRadiusSize": integer,
  "bubbleTextStyle": {
    object (TextFormat)
  }
}

字段
`legendPosition`	`enum (BubbleChartLegendPosition)` 图表图例应绘制的位置。
`bubbleLabels`	`object (ChartData)` 包含气泡标签的数据。这些值不必是唯一的。
`domain`	`object (ChartData)` 包含气泡 x 值的数据。这些值用于在图表中水平定位气泡。
`series`	`object (ChartData)` 包含气泡 y 值的数据。这些值用于垂直定位图表中的气泡。
`groupIds`	`object (ChartData)` 包含气泡组 ID 的数据。具有相同组 ID 的所有气泡均以相同的颜色绘制。如果指定了 `bubbleSizes`，则还必须指定此字段，但可以包含空值。此字段是可选字段。
`bubbleSizes`	`object (ChartData)` 包含气泡大小的数据。气泡大小用于绘制彼此相对的不同大小的气泡。如果指定了该字段，则还必须指定 `groupIds`。此字段是可选字段。
`bubbleOpacity`	`number` 气泡的不透明度，介于 0 到 1.0 之间。0 表示完全透明，1 表示完全不透明。
`bubbleBorderColor (deprecated)`	`object (Color)` 此项已弃用！气泡边框颜色。已废弃：请使用 `bubbleBorderColorStyle`。
`bubbleBorderColorStyle`	`object (ColorStyle)` 气泡边框颜色。如果同时设置了 `bubbleBorderColor`，则此字段优先。
`bubbleMaxRadiusSize`	`integer` 气泡的最大半径大小（以像素为单位）。如果指定，该字段必须为正值。
`bubbleMinRadiusSize`	`integer` 气泡的最小半径大小（以像素为单位）。如果是具体值，该字段必须为正值。
`bubbleTextStyle`	`object (TextFormat)` 气泡内文本的格式。不支持删除线、下划线和链接。

BubbleChartLegendPosition

图表图例应放置的位置。

枚举
`BUBBLE_CHART_LEGEND_POSITION_UNSPECIFIED`	默认值，请勿使用。
`BOTTOM_LEGEND`	图例会渲染在图表底部。
`LEFT_LEGEND`	图例会渲染在图表的左侧。
`RIGHT_LEGEND`	图例会渲染在图表右侧。
`TOP_LEGEND`	图例会呈现在图表顶部。
`NO_LEGEND`	系统不会渲染图例。
`INSIDE_LEGEND`	图例会在图表区域内呈现。

CandlestickChartSpec

K 线图。

JSON 表示法
{ "domain": { object (`CandlestickDomain`) }, "data": [ { object (`CandlestickData`) } ] }

字段

domain

object (CandlestickDomain)

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

data[]

object (CandlestickData)

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

CandlestickDomain

CandlestickChart 的网域。

JSON 表示法
{ "data": { object (`ChartData`) }, "reversed": boolean }

字段

data

object (ChartData)

CandlestickDomain 的数据。

reversed

boolean

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

CandlestickData

K 线图数据，每个数据包含系列的最低价、开盘价、收盘价和最高价。

JSON 表示法
{ "lowSeries": { object (`CandlestickSeries`) }, "openSeries": { object (`CandlestickSeries`) }, "closeSeries": { object (`CandlestickSeries`) }, "highSeries": { object (`CandlestickSeries`) } }

字段
`lowSeries`	`object (CandlestickSeries)` 每个蜡烛图的低值/最小值的范围数据（垂直轴）。这是 K 线中轴线的底部。
`openSeries`	`object (CandlestickSeries)` 每个蜡烛图的开盘价/初始值的范围数据（垂直轴）。这是实体烛体的底部。如果小于收盘价，则 K 线为实心，否则，蜡烛将是空心的。
`closeSeries`	`object (CandlestickSeries)` 每个蜡烛图的收盘价/最终值的范围数据（垂直轴）。这是实体烛体的顶部。如果大于开盘价，则 K 线为实心。否则，蜡烛将是空心的。
`highSeries`	`object (CandlestickSeries)` 每个蜡烛图的最高值的范围数据（垂直轴）。这是 K 线上影线的最高点。

CandlestickSeries

CandlestickData 的系列。

JSON 表示法
{ "data": { object (`ChartData`) } }

字段

data

object (ChartData)

CandlestickSeries 的数据。

OrgChartSpec

组织结构图。组织结构图需要在 labels 中包含一组唯一的标签，并且可以选择性地包含 parentLabels 和 tooltips。 parentLabels 针对每个节点，包含用于标识父节点的标签。 tooltips 针对每个节点包含一个可选的提示。

例如，若要描述一个组织架构，其中 Alice 为首席执行官 (CEO)、Bob 为总裁（向 Alice 汇报）、Cathy 为销售副总裁（也向 Alice 汇报），请将 labels 设置为包含“Alice”“Bob”“Cathy”，parentLabels 设置为包含“”“Alice”“Alice”，tooltips 设置为包含“CEO”“总裁”“销售副总裁”。

JSON 表示法

{
  "nodeSize": enum (OrgChartNodeSize),
  "nodeColor": {
    object (Color)
  },
  "nodeColorStyle": {
    object (ColorStyle)
  },
  "selectedNodeColor": {
    object (Color)
  },
  "selectedNodeColorStyle": {
    object (ColorStyle)
  },
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "tooltips": {
    object (ChartData)
  }
}

字段
`nodeSize`	`enum (OrgChartNodeSize)` 组织架构节点的大小。
`nodeColor (deprecated)`	`object (Color)` 此项已弃用！组织结构图节点的颜色。已废弃：请使用 `nodeColorStyle`。
`nodeColorStyle`	`object (ColorStyle)` 组织结构图节点的颜色。如果同时设置了 `nodeColor`，则此字段优先。
`selectedNodeColor (deprecated)`	`object (Color)` 此项已弃用！所选组织结构图节点的颜色。已废弃：请使用 `selectedNodeColorStyle`。
`selectedNodeColorStyle`	`object (ColorStyle)` 所选组织结构图节点的颜色。如果同时设置了 `selectedNodeColor`，则此字段优先。
`labels`	`object (ChartData)` 包含图表中所有节点的标签的数据。标签必须是唯一的。
`parentLabels`	`object (ChartData)` 包含相应节点父级标签的数据。空值表示该节点没有父级，是顶级节点。此字段是可选字段。
`tooltips`	`object (ChartData)` 包含相应节点的提示的数据。如果值为空，系统将不会为节点显示任何提示。此字段是可选字段。

OrgChartNodeSize

组织架构节点的大小。

枚举
`ORG_CHART_LABEL_SIZE_UNSPECIFIED`	默认值，请勿使用。
`SMALL`	组织架构节点的尺寸较小。
`MEDIUM`	中等组织图节点大小。
`LARGE`	组织架构节点的大小过大。

HistogramChartSpec

直方图。直方图会将数据项分组到多个分箱中，并将每个分箱显示为堆叠项的列。直方图用于显示数据集的分布情况。每列项代表这些项所属的范围。可以自动选择或显式指定分箱数。

JSON 表示法
{ "series": [ { object (`HistogramSeries`) } ], "legendPosition": enum (`HistogramChartLegendPosition`), "showItemDividers": boolean, "bucketSize": number, "outlierPercentile": number }

字段
`series[]`	`object (HistogramSeries)` 直方图的系列可以是一系列要分桶的值，也可以是多个系列（每个系列的长度相同），其中包含系列名称，后跟要为该系列分桶的值。
`legendPosition`	`enum (HistogramChartLegendPosition)` 图表图例的位置。
`showItemDividers`	`boolean` 是否应在每列中的项之间显示水平分隔线。
`bucketSize`	`number` 默认情况下，系统会自动选择分桶大小（单个列中堆叠的值的范围），但您可以在此处替换该大小。例如，如果存储分区大小为 1.5，则存储分区的范围为 0-1.5、1.5-3.0 等。不能为负数。此字段是可选字段。
`outlierPercentile`	`number` 离群值百分位数用于确保离群值不会对存储分区大小的计算产生不利影响。例如，如果将离群值百分位数设置为 0.05，则表示在计算分桶时，将排除 5% 的最高值和最低值。这些值仍会包含在图表中，但会添加到第一个或最后一个分桶中，而不是添加到自己的分桶中。必须介于 0.0 到 0.5 之间。

HistogramSeries

包含系列颜色和数据的直方图系列。

JSON 表示法
{ "barColor": { object (`Color`) }, "barColorStyle": { object (`ColorStyle`) }, "data": { object (`ChartData`) } }

字段

barColor
       

       
        (deprecated)

object (Color)

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

barColorStyle

object (ColorStyle)

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

data

object (ChartData)

此直方图系列的数据。

HistogramChartLegendPosition

图表图例应放置的位置。

枚举
`HISTOGRAM_CHART_LEGEND_POSITION_UNSPECIFIED`	默认值，请勿使用。
`BOTTOM_LEGEND`	图例会渲染在图表底部。
`LEFT_LEGEND`	图例会渲染在图表的左侧。
`RIGHT_LEGEND`	图例会渲染在图表右侧。
`TOP_LEGEND`	图例会呈现在图表顶部。
`NO_LEGEND`	系统不会渲染图例。
`INSIDE_LEGEND`	图例会在图表区域内呈现。

WaterfallChartSpec

瀑布图。

JSON 表示法

{
  "domain": {
    object (WaterfallChartDomain)
  },
  "series": [
    {
      object (WaterfallChartSeries)
    }
  ],
  "stackedType": enum (WaterfallChartStackedType),
  "firstValueIsTotal": boolean,
  "hideConnectorLines": boolean,
  "connectorLineStyle": {
    object (LineStyle)
  },
  "totalDataLabel": {
    object (DataLabel)
  }
}

字段
`domain`	`object (WaterfallChartDomain)` 瀑布图的网域数据（横轴）。
`series[]`	`object (WaterfallChartSeries)` 此瀑布图所直观呈现的数据。
`stackedType`	`enum (WaterfallChartStackedType)` 堆叠类型。
`firstValueIsTotal`	`boolean` 设为 true 以将第一个值解读为总计。
`hideConnectorLines`	`boolean` 设置为 true 可隐藏列之间的连接线。
`connectorLineStyle`	`object (LineStyle)` 连接线的线条样式。
`totalDataLabel`	`object (DataLabel)` 用于控制是否在堆叠图表中显示额外的数据标签，这些标签会对域轴上每个值的所有堆叠值进行求和。 `stackedType` 必须为 `STACKED`，并且不能在 `totalDataLabel` 上设置 `CUSTOM` 或 `placement`。

WaterfallChartDomain

瀑布图的网域。

JSON 表示法
{ "data": { object (`ChartData`) }, "reversed": boolean }

字段

data

object (ChartData)

WaterfallChartDomain 的数据。

reversed

boolean

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

WaterfallChartSeries

瀑布图的单个数据系列。

JSON 表示法

{
  "data": {
    object (ChartData)
  },
  "positiveColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "negativeColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "subtotalColumnsStyle": {
    object (WaterfallChartColumnStyle)
  },
  "hideTrailingSubtotal": boolean,
  "customSubtotals": [
    {
      object (WaterfallChartCustomSubtotal)
    }
  ],
  "dataLabel": {
    object (DataLabel)
  }
}

字段
`data`	`object (ChartData)` 此系列中可视化的数据。
`positiveColumnsStyle`	`object (WaterfallChartColumnStyle)` 此系列中所有值为正数的列的样式。
`negativeColumnsStyle`	`object (WaterfallChartColumnStyle)` 此系列中所有负值列的样式。
`subtotalColumnsStyle`	`object (WaterfallChartColumnStyle)` 此系列中所有子总计列的样式。
`hideTrailingSubtotal`	`boolean` 设置为 True 可隐藏系列图表末尾的“小计”列。默认情况下，每个系列的末尾都会显示一个小计列。如果将此字段设置为 true，系统会隐藏此系列的此小计列。
`customSubtotals[]`	`object (WaterfallChartCustomSubtotal)` 此系列中显示的自定义小计列。定义小计的顺序并不重要。每个数据点只能定义一个小计。
`dataLabel`	`object (DataLabel)` 此系列数据标签的相关信息。

WaterfallChartColumnStyle

瀑布图列的样式。

JSON 表示法
{ "label": string, "color": { object (`Color`) }, "colorStyle": { object (`ColorStyle`) } }

字段

label

string

列图例的标签。

color
       

       
        (deprecated)

object (Color)

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

colorStyle

object (ColorStyle)

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

WaterfallChartCustomSubtotal

瀑布图系列的自定义小计列。

JSON 表示法
{ "subtotalIndex": integer, "label": string, "dataIsSubtotal": boolean }

字段

subtotalIndex

integer

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

label

string

小计列的标签。

dataIsSubtotal

boolean

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

WaterfallChartStackedType

适用于瀑布图的堆叠类型选项。

枚举
`WATERFALL_STACKED_TYPE_UNSPECIFIED`	默认值，请勿使用。
`STACKED`	与同一领域（横轴）值对应的值将垂直堆叠。
`SEQUENTIAL`	系列图表将沿水平轴展开。

TreemapChartSpec

树状图。

JSON 表示法

{
  "labels": {
    object (ChartData)
  },
  "parentLabels": {
    object (ChartData)
  },
  "sizeData": {
    object (ChartData)
  },
  "colorData": {
    object (ChartData)
  },
  "textFormat": {
    object (TextFormat)
  },
  "levels": integer,
  "hintedLevels": integer,
  "minValue": number,
  "maxValue": number,
  "headerColor": {
    object (Color)
  },
  "headerColorStyle": {
    object (ColorStyle)
  },
  "colorScale": {
    object (TreemapChartColorScale)
  },
  "hideTooltips": boolean
}

字段
`labels`	`object (ChartData)` 包含树状图单元格标签的数据。
`parentLabels`	`object (ChartData)` 包含树状图单元格的父标签的数据。
`sizeData`	`object (ChartData)` 用于确定每个树形图数据单元格的大小的数据。此数据应为数字。系统不会渲染与非数字数据或缺失数据对应的单元格。如果未指定 `colorData`，系统还会使用此数据来确定数据单元格的背景颜色。
`colorData`	`object (ChartData)` 用于确定每个树状图数据单元格的背景颜色的数据。此字段是可选字段。如果未指定，则系统会使用 `sizeData` 来确定背景颜色。如果指定，数据应为数字。 `colorScale`将决定此数据中的值如何映射到数据单元格的背景颜色。
`textFormat`	`object (TextFormat)` 图表上所有标签的文本格式。不支持链接字段。
`levels`	`integer` 要在树状图图表中显示的数据级别数量。这些等级是互动的，并会显示其标签。如果未指定，则默认为 2。
`hintedLevels`	`integer` 除了要在树状图表中显示的标记级别之外，其他数据级别的数量。这些等级不可互动，且在显示时不带标签。如果未指定，则默认为 0。
`minValue`	`number` 可能的最小数据值。值低于此值的单元格将与值等于此值的单元格具有相同的颜色。如果未指定，则默认为 `colorData` 中的实际最小值，如果未指定 `colorData`，则默认为 `sizeData` 中的最小值。
`maxValue`	`number` 可能的最大数据值。值大于此值的单元格将与值等于此值的单元格具有相同的颜色。如果未指定，则默认为 `colorData` 中的实际最大值，如果未指定 `colorData`，则默认为 `sizeData` 中的最大值。
`headerColor (deprecated)`	`object (Color)` 此项已弃用！标题单元格的背景颜色。已废弃：请使用 `headerColorStyle`。
`headerColorStyle`	`object (ColorStyle)` 标题单元格的背景颜色。如果同时设置了 `headerColor`，则此字段优先。
`colorScale`	`object (TreemapChartColorScale)` 树状图图表中数据单元格的颜色比例。系统会根据数据单元格的颜色值为其分配颜色。这些颜色值来自 `colorData`，如果未指定 `colorData`，则来自 `sizeData`。颜色值小于或等于 `minValue` 的单元格将采用 `minValueColor` 作为背景颜色。颜色值大于或等于 `maxValue` 的单元格的背景颜色为 `maxValueColor`。颜色值介于 `minValue` 和 `maxValue` 之间的单元格的背景颜色将介于 `minValueColor` 和 `maxValueColor` 之间的渐变色，渐变的中间点为 `midValueColor`。缺少颜色值或颜色值非数字的单元格的背景颜色将为 `noDataColor`。
`hideTooltips`	`boolean` 设为 true 可隐藏提示。

TreemapChartColorScale

树状图的颜色比例。

JSON 表示法

{
  "minValueColor": {
    object (Color)
  },
  "minValueColorStyle": {
    object (ColorStyle)
  },
  "midValueColor": {
    object (Color)
  },
  "midValueColorStyle": {
    object (ColorStyle)
  },
  "maxValueColor": {
    object (Color)
  },
  "maxValueColorStyle": {
    object (ColorStyle)
  },
  "noDataColor": {
    object (Color)
  },
  "noDataColorStyle": {
    object (ColorStyle)
  }
}

字段
`minValueColor (deprecated)`	`object (Color)` 此项已弃用！颜色值小于或等于 `minValue` 的单元格的背景颜色。如果未指定，则默认为 #dc3912。已废弃：请使用 `minValueColorStyle`。
`minValueColorStyle`	`object (ColorStyle)` 颜色值小于或等于 `minValue` 的单元格的背景颜色。如果未指定，则默认为 #dc3912。如果同时设置了 `minValueColor`，则此字段优先。
`midValueColor (deprecated)`	`object (Color)` 此项已弃用！颜色值介于 `minValue` 和 `maxValue` 之间的单元格的背景颜色。如果未指定，则默认为 #efe6dc。已废弃：请使用 `midValueColorStyle`。
`midValueColorStyle`	`object (ColorStyle)` 颜色值介于 `minValue` 和 `maxValue` 之间的单元格的背景颜色。如果未指定，则默认为 #efe6dc。如果同时设置了 `midValueColor`，则此字段优先。
`maxValueColor (deprecated)`	`object (Color)` 此项已弃用！颜色值大于或等于 `maxValue` 的单元格的背景颜色。如果未指定，则默认为 #109618。已废弃：请使用 `maxValueColorStyle`。
`maxValueColorStyle`	`object (ColorStyle)` 颜色值大于或等于 `maxValue` 的单元格的背景颜色。如果未指定，则默认为 #109618。如果同时设置了 `maxValueColor`，则此字段优先。
`noDataColor (deprecated)`	`object (Color)` 此项已弃用！没有关联颜色数据的单元格的背景颜色。如果未指定，则默认为 #000000。已废弃：请使用 `noDataColorStyle`。
`noDataColorStyle`	`object (ColorStyle)` 没有关联颜色数据的单元格的背景颜色。如果未指定，则默认为 #000000。如果同时设置了 `noDataColor`，则此字段优先。

ScorecardChartSpec

统计信息摘要图表。计分卡图表用于在电子表格中突出显示关键绩效指标 (KPI)。统计信息摘要图表可以显示总销售额、平均费用或畅销商品等信息。您可以指定单个数据值，也可以对一组数据进行汇总。您可以突出显示与基准值的百分比差异或绝对差异，例如一段时间内的变化。

JSON 表示法

{
  "keyValueData": {
    object (ChartData)
  },
  "baselineValueData": {
    object (ChartData)
  },
  "aggregateType": enum (ChartAggregateType),
  "keyValueFormat": {
    object (KeyValueFormat)
  },
  "baselineValueFormat": {
    object (BaselineValueFormat)
  },
  "scaleFactor": number,
  "numberFormatSource": enum (ChartNumberFormatSource),
  "customFormatOptions": {
    object (ChartCustomNumberFormatOptions)
  }
}

字段
`keyValueData`	`object (ChartData)` 计分卡键值对的数据。
`baselineValueData`	`object (ChartData)` 统计信息摘要基准值的数据。此字段是可选字段。
`aggregateType`	`enum (ChartAggregateType)` 计分卡图表中关键图表数据和基准图表数据的汇总类型。数据源图表不支持此字段。对于数据源图表，请改用 `keyValueData` 或 `baselineValueData` 的 `ChartData.aggregateType` 字段。此字段是可选字段。
`keyValueFormat`	`object (KeyValueFormat)` 键值的格式设置选项。
`baselineValueFormat`	`object (BaselineValueFormat)` 基准值的格式设置选项。只有在指定了 `baselineValueData` 时，才需要此字段。
`scaleFactor`	`number` 用于缩放计分卡键值和基准值的值。例如，系数 10 可用于将图表中的所有值除以 10。此字段是可选字段。
`numberFormatSource`	`enum (ChartNumberFormatSource)` 计分卡图表中使用的数字格式来源。此字段是可选字段。
`customFormatOptions`	`object (ChartCustomNumberFormatOptions)` 统计信息摘要图表中数值键值/基准值的自定义格式设置选项。仅当 `numberFormatSource` 设置为 `CUSTOM` 时，才会使用此字段。此字段是可选字段。

KeyValueFormat

键值的格式设置选项。

JSON 表示法
{ "textFormat": { object (`TextFormat`) }, "position": { object (`TextPosition`) } }

字段

textFormat

object (TextFormat)

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

position

object (TextPosition)

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

BaselineValueFormat

基准值的格式设置选项。

JSON 表示法

{
  "comparisonType": enum (ComparisonType),
  "textFormat": {
    object (TextFormat)
  },
  "position": {
    object (TextPosition)
  },
  "description": string,
  "positiveColor": {
    object (Color)
  },
  "positiveColorStyle": {
    object (ColorStyle)
  },
  "negativeColor": {
    object (Color)
  },
  "negativeColorStyle": {
    object (ColorStyle)
  }
}

字段
`comparisonType`	`enum (ComparisonType)` 键值与基准值的比较类型。
`textFormat`	`object (TextFormat)` 基准值的文本格式选项。不支持链接字段。
`position`	`object (TextPosition)` 指定基准值的水平文本位置。此字段是可选字段。如果未指定，则使用默认定位。
`description`	`string` 附加到基准值后面的说明。此字段是可选字段。
`positiveColor (deprecated)`	`object (Color)` 此项已弃用！要使用的颜色，如果基准值表示键值的正变化。此字段是可选字段。已废弃：请使用 `positiveColorStyle`。
`positiveColorStyle`	`object (ColorStyle)` 要使用的颜色，如果基准值表示键值的正变化。此字段是可选字段。如果同时设置了 `positiveColor`，则此字段优先。
`negativeColor (deprecated)`	`object (Color)` 此项已弃用！要使用的颜色，如果基准值表示关键值的负值变化。此字段是可选字段。已废弃：请使用 `negativeColorStyle`。
`negativeColorStyle`	`object (ColorStyle)` 要使用的颜色，如果基准值表示关键值的负值变化。此字段是可选字段。如果同时设置了 `negativeColor`，则此字段优先。

ComparisonType

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

枚举
`COMPARISON_TYPE_UNDEFINED`	默认值，请勿使用。
`ABSOLUTE_DIFFERENCE`	使用键值与基准值之间的绝对差。
`PERCENTAGE_DIFFERENCE`	使用键值与基准值之间的百分比差异。

ChartNumberFormatSource

图表属性的数字格式设置来源选项。

枚举
`CHART_NUMBER_FORMAT_SOURCE_UNDEFINED`	默认值，请勿使用。
`FROM_DATA`	从数据继承数字格式。
`CUSTOM`	应用 `ChartCustomNumberFormatOptions` 指定的自定义格式。

ChartCustomNumberFormatOptions

图表属性的自定义数字格式设置选项。

JSON 表示法
{ "prefix": string, "suffix": string }

字段

prefix

string

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

suffix

string

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

ChartHiddenDimensionStrategy

确定图表应如何处理隐藏的来源行。隐藏的行包括手动隐藏的行和被过滤器隐藏的行。

枚举
`CHART_HIDDEN_DIMENSION_STRATEGY_UNSPECIFIED`	默认值，请勿使用。
`SKIP_HIDDEN_ROWS_AND_COLUMNS`	图表会跳过隐藏的行和列。
`SKIP_HIDDEN_ROWS`	图表仅会跳过隐藏的行。
`SKIP_HIDDEN_COLUMNS`	图表只会跳过隐藏的列。
`SHOW_ALL`	图表不会跳过任何隐藏的行或列。

EmbeddedObjectBorder

嵌入对象的边框。

JSON 表示法
{ "color": { object (`Color`) }, "colorStyle": { object (`ColorStyle`) } }

字段

color
       

       
        (deprecated)

object (Color)

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

colorStyle

object (ColorStyle)

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

Charts 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

EmbeddedChart

ChartSpec

TextPosition

DataSourceChartProperties

BasicChartSpec

BasicChartType

BasicChartLegendPosition

BasicChartAxis

BasicChartAxisPosition

ChartAxisViewWindowOptions

ViewWindowMode

BasicChartDomain

ChartData

ChartSourceRange

ChartGroupRule

ChartDateTimeRule

ChartDateTimeRuleType

ChartHistogramRule

ChartAggregateType

BasicChartSeries

LineStyle

LineDashType

DataLabel

DataLabelType

DataLabelPlacement

PointStyle

PointShape

BasicSeriesDataPointStyleOverride

BasicChartStackedType

BasicChartCompareMode

PieChartSpec

PieChartLegendPosition

BubbleChartSpec

BubbleChartLegendPosition

CandlestickChartSpec

CandlestickDomain

CandlestickData

CandlestickSeries

OrgChartSpec

OrgChartNodeSize

HistogramChartSpec

HistogramSeries

HistogramChartLegendPosition

WaterfallChartSpec

WaterfallChartDomain

WaterfallChartSeries

WaterfallChartColumnStyle

WaterfallChartCustomSubtotal

WaterfallChartStackedType

TreemapChartSpec

TreemapChartColorScale

ScorecardChartSpec

KeyValueFormat

BaselineValueFormat

ComparisonType

ChartNumberFormatSource

ChartCustomNumberFormatOptions

ChartHiddenDimensionStrategy

EmbeddedObjectBorder

Charts